Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Returns or sets the drawing attributes to apply to the ink of an IInkStrokeDispobject as it is drawn.

Syntax

[propputref] HRESULT putref_DrawingAttributes (
	[in] InkDrawingAttributes *DrawingAttributes);
[propget] HRESULT get_DrawingAttributes (
	[out, retval] InkDrawingAttributes **DrawingAttributes);

Parameters

DrawingAttributes

Returns or sets the IInkDrawingAttributesobject that determines the attributes to apply to ink as it is drawn. If this object is NULL, the cursor uses the default drawing attributes of the IInkOverlayobject.

This property is read/write.

Return Value

HRESULT value Description

S_OK

Success. The parameter contains the attributes that you set for the known cursor.

E_OUTOFMEMORY

Cannot allocate memory to store the drawing attributes.

E_INK_EXCEPTION

An exception occurred while processing.

E_POINTER

A parameter contains an invalid pointer.

E_FAIL

An unspecified error occurred.

E_UNEXPECTED

Unexpected parameter or property type.

REGDB_CLASSNOTREG

The IInkDrawingAttributesobject was not registered.

Remarks

The drawing attributes specify the appearance of the stroke. For example, you can specify the style and color of a pen.

Successive calls to the DrawingAttributesproperty change only the drawing attributes of new strokes. They do not apply to strokes that are already collected or being collected.

Note:
This property behaves differently than the IInkOverlay::DefaultDrawingAttributesproperty. Although the DefaultDrawingAttributesproperty specifies the drawing attributes that are applied to a new cursor, the DrawingAttributesproperty specifies the drawing attributes for ink that is yet to be collected.

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also