IInkCursor Interface
IInkCursor Interface |
Represents general information about the tablet cursor.
Members
| Property | Description |
|---|---|
| Buttons | Returns the CursorButtons collection that is available on a known IInkCursor. |
| DrawingAttributes | Gets or sets the drawing attributes to apply to ink as it is drawn. |
| Id | Gets the identifier of the IInkCursor object. |
| Inverted | Gets a value that indicates whether the cursor is the inverted end of the pen. |
| Name | Gets the name of the IInkCursor object. |
| Tablet | Gets the tablet device to which the IInkCursor belongs. |
Remarks
A 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 Overview.
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.
A IInkCursor cannot be constructed explicitly. Instead, you obtain a Cursor from either events or the Cursors property of an InkCollector object, an InkOverlay object, or an InkPicture control.
COM Implementation
This object implements the IInkCursor COM interface.