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. |
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 |