InkOverlay.DefaultDrawingAttributes property

Applies to: desktop apps only

Gets or sets the default drawing attributes to use when drawing and displaying ink.

This property is read/write.

Syntax

HRESULT put_DefaultDrawingAttributes(
  [in]           IInkDrawingAttributes *NewAttributes
);

HRESULT get_DefaultDrawingAttributes(
  [out, retval]  IInkDrawingAttributes **CurrentAttributes
);

Property value

The default InkDrawingAttributes object, which specifies the drawing attributes that are used when drawing and displaying ink.

Error codes

Remarks

The drawing attributes specified with this property are the attributes that are assigned to a new cursor.

The default drawing attributes are as follows:

AntiAliased = TRUE

Color = BLACK (RGB(0,0,0)) if not in High Contrast mode; otherwise, Color=COLOR_WINDOWTEXT.

FitToCurve = FALSE

Height = 1 (in ink space units)

IgnorePressure = FALSE

PenTip = Ball

RasterOperation = CopyPen

Transparency = 0 (totally opaque)

Width = 53 (in ink space units)

To set different attributes on a new cursor, use the DrawingAttributes property of the IInkCursor object.

To change the drawing attributes of a single stroke, use the DrawingAttributes property of the IInkStrokeDisp object. To change the drawing attributes of a collection of strokes, call the ModifyDrawingAttributes method of the InkStrokes collection.

Note  The DefaultDrawingAttributes property contains the drawing attributes that all cursors use unless they set their own DrawingAttributes property. For example, a new IInkCursor object uses DefaultDrawingAttributes, and an old IInkCursor object on which the DrawingAttributes is set to NULL also uses DefaultDrawingAttributes.

Requirements

See also

InkOverlay Class

DrawingAttributes Property

ModifyDrawingAttributes Method

IInkCursor Interface

InkDrawingAttributes Class

IInkStrokeDisp Interface

InkStrokes Collection

Send comments about this topic to Microsoft

Build date: 3/6/2012