InkPicture.Cursors property
Gets the collection of cursors that are available for use in the inking region. Each cursor corresponds to the tip of a pen or other ink input device.
This property is read-only.
Syntax
HRESULT get_Cursors( [out, retval] IInkCursors **Cursors );
Property value
A pointer to the collection of cursors that this InkCollector has encountered.
Error codes
| Name | Meaning |
|---|---|
|
Success. |
|
The Cursors parameter must be a valid pointer to an IInkCursors pointer. |
|
An unspecified error occurred. |
|
An exception occurred inside the method. |
Remarks
Cursors are local to an InkCollector object.
Any new cursors that the InkCollector encounters are added to the returned collection of cursors, although the returned cursors are not necessarily returned in the order in which the InkCollector encounters them.
When a mouse is enabled as an input device on the InkCollector (when the useMouse parameter of the SetAllTabletsMode method is TRUE), the mouse is added to the IInkCursors collection after the InkCollector encounters any other cursor, such as a pen. This is because the pen also acts like a mouse.
The IInkCursors collection is reset (count set to 0, containing no objects) when:
- The tablet mode is changed (for example, from SetSingleTabletIntegratedMode to SetAllTabletsMode).
- The SetSingleTabletIntegratedMode method is called.
Requirements
|
Minimum supported client |
Windows XP Tablet PC Edition [desktop apps only] |
|---|---|
|
Minimum supported server |
None supported |
|
Header |
|
|
Library |
|
See also
- InkPicture
- InkPicture Control
- MouseIcon Property
- MousePointer Property
- SetAllTabletsMode Method
- SetSingleTabletIntegratedMode Method
- IInkCursors Interface