Export (0) Print
Expand All

IInkCursor interface

Applies to: desktop apps only

Represents general information about the tablet cursor.

Members

The IInkCursor interface inherits from the IUnknown interface. IInkCursor also has these types of members:

Properties

The IInkCursor interface has these properties.

PropertyAccess typeDescription

Buttons

Read-only

Returns the CursorButtons collection that is available on a known IInkCursor.

DrawingAttributes

Read/write

Gets or sets the drawing attributes to apply to ink as it is drawn.

Id

Read-only

Gets the identifier of the IInkCursor object.

Inverted

Read-only

Gets a value that indicates whether the cursor is the inverted end of the pen.

Name

Read-only

Gets the name of the IInkCursor object.

Tablet

Read-only

Gets the tablet device to which the IInkCursor belongs.

 

Remarks

An IInkCursor object represents the physical pen that the user holds. Physical pens may have multiple tips - such as normal and eraser ends - with each pen tip representing a different IInkCursor object. Some Tablet PCs allow multiple pens. Each cursor has an associated identifier that is unique on a system. For more information about how pens can be used with Tablet PC, see Pen Input, Ink, and Recognition.

A specific set of drawing attributes can be assigned to a known cursor, such as whether the pen color should be red or blue. A cursor also contains a collection of zero or more IInkCursorButton objects.

Cursors exist only within the scope of an InkCollector object, an InkOverlay object, or an InkPicture control. When one of these objects encounters a new cursor, the object fires its CursorInRange event with the newCursor parameter set to TRUE. This allows you to set up properties in the application, such as drawing attributes, when the cursor is first encountered. The Cursors property contains the collection of cursors that the object or control has encountered.

An IInkCursor cannot be constructed explicitly. Instead, you obtain an IInkCursor from either events or the Cursors property of an InkCollector object, an InkOverlay object, or an InkPicture control.

If you define a class that implements this interface, the new class will not interact correctly with the Tablet PC application programming interfaces (APIs).

Requirements

Minimum supported client

Windows XP Tablet PC Edition

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

Cursors Property
IInkCursorButton Interface
IInkCursorButtons Interface
IInkCursors Interface
IInkCursors Interface
InkDrawingAttributes Class
InkCollector Class
InkOverlay Class
InkPicture Control Reference
IInkTablet Interface

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2015 Microsoft