IInkCursorButton interface

Represents general information about a button on a tablet pointing and selecting device.


The IInkCursorButton interface has these methods.

Method Description
IInkCursorButton::get_Id Gets the identifier of an object.
IInkCursorButton::get_Name Gets the name of the object.
IInkCursorButton::get_State Gets the state of a cursor button, such as whether the button is unavailable, up, or down.


An IInkCursor can contain zero to 32 associated buttons, and these buttons are provided to an application as IInkCursorButton objects. Examples of cursor buttons are:

  • The writing end of a pen
  • The inverted (or "eraser") end of a pen
  • The barrel of a pen
  • The button on a pen
A single pen cursor with no barrel may consist of two cursor buttons: the writing end and the inverted end. Each button can have a specific function, and an application must know which button, by identifier, is being used before it can accept input from the cursor. For example, an application must know the identifier of the inverted end of the pen before strokes can be erased.

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


Minimum supported client Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header msinkaut.h

See also

Buttons Property

IInkCursor Interface

IInkCursorButtons Interface