This documentation is archived and is not being maintained.

Cursor Class

Represents general information about a tablet pointing and selecting device.

Namespace:  Microsoft.Ink
Assembly:  Microsoft.Ink (in Microsoft.Ink.dll)

public class Cursor

A Cursor object represents a pointing and selecting device, such as a stylus or a mouse. Physical pens may have multiple tips—such as normal and eraser ends—with each pen tip representing a different Cursor object. A Tablet PC may allow multiple pens. Each cursor has an associated cursor identifier that is unique on a system. For more information about how pens can be used with a Tablet PC, see Pen Input, Ink, and Recognition, Text Input Using the Pen, and Command Input on the Tablet PC.

You can assign specific drawing attributes 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 CursorButton 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 an InkCollector.CursorInRange, an InkOverlay.CursorInRange, or an InkPicture.CursorInRange event with the NewCursor property of the InkCollectorCursorInRangeEventArgs object set to true. This allows you to set up properties in the application, such as drawing attributes, when the cursor is first encountered. The InkCollector.Cursors, InkOverlay.Cursors, and InkPicture.Cursors properties contain the collection of cursors that the object or control has encountered.

A Cursor cannot be constructed explicitly. Instead, you obtain a Cursor from either event arguments or the Cursors property of an Microsoft.Ink.InkCollector object, an Microsoft.Ink.InkOverlay object, or an Microsoft.Ink.InkPicture control.


Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.0