Share via


IInkStrokeDisp::DrawingAttributes

4/8/2010

Returns or sets the drawing attributes to apply to the ink of an IInkStrokeDisp object 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 IInkDrawingAttributes object 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 IInkOverlay object.

    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 IInkDrawingAttributes object 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 DrawingAttributes property 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::DefaultDrawingAttributes property. Although the DefaultDrawingAttributes property specifies the drawing attributes that are applied to a new cursor, the DrawingAttributes property 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

Concepts

Windows Mobile Ink Reference