InkEdit.DrawingAttributes property

Gets or sets the drawing attributes for ink that is yet to be drawn on the InkEdit control.

This property is read/write.

Syntax


HRESULT get_DrawingAttributes(
  [out, retval] InkDrawingAttributes **pVal
);

Property value

Error codes

NameMeaning
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 property type.

REGDB_CLASSNOTREG

The InkDrawingAttributes object was not registered.

Remarks

The DrawingAttributes property specifies the appearance of the IInkStrokeDisp object. For example, you can specify the width and color of ink drawn on the InkEdit control.

Successive calls to the DrawingAttributes property change only the DrawingAttributes properties of new IInkStrokeDisp objects. The calls do not apply to IInkStrokeDisp objects that the InkEdit control already collected or is in the process of collecting.

This property is different from the DrawingAttributes property of the IInkStrokeDisp object, which specifies the attributes of already collected ink. The InkEdit control's DrawingAttributes property is more analogous to the InkPicture object's DefaultDrawingAttributes property, except that for the DefaultDrawingAttributes property the FitToCurve property is set to TRUE by default.

Requirements

Minimum supported client

Windows XP Tablet PC Edition [desktop apps only]

Minimum supported server

None supported

Header

Inked.h (also requires inked_i.c)

Library

InkEd.dll

See also

InkEdit
InkDrawingAttributes Class

 

 

Show: