This documentation is archived and is not being maintained.

InkOverlay::CursorDown Event

Occurs when the cursor tip contacts the digitizing tablet surface.

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

 event InkCollectorCursorDownEventHandler^ CursorDown {
	void add (InkCollectorCursorDownEventHandler^ value);
	void remove (InkCollectorCursorDownEventHandler^ value);

The event handler receives an argument of type InkCollectorCursorDownEventArgs containing data about this event.

When you create an InkCollectorCursorDownEventHandler delegate, you identify the method that handles the event. To associate the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever the event occurs, unless you remove the delegate. For performance reasons, the default event interest is off but is turned on automatically if you add an event handler.

This event may have an adverse effect on ink performance if too much code is executed in the event handlers. To improve real-time ink performance, hide the mouse cursor while inking. To do so, hide the mouse cursor in the MouseDown event handler, and show the mouse cursor in the MouseUp event handler.

This example demonstrates how you can subscribe to the CursorDown event, and the Stroke event to calculate the length of time it takes the user to create a stroke.

At the beginning of a stroke, the CursorDown event fires. The current time is placed into the ExtendedProperties collection of the Stroke object.

No code example is currently available or this language may not be supported.

When the stroke is complete, the Stroke event fires. Tthe start time is retrieved from the ExtendedProperties collection of the Stroke object, and used to calculate the elapsed time.

No code example is currently available or this language may not be supported.

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