InkPicture.SystemGesture event

Occurs when a system gesture is recognized.

Syntax

void SystemGesture(
  [in] IInkCursor       *Cursor,
  [in] InkSystemGesture Id,
  [in] long             X,
  [in] long             Y,
  [in] long             Modifier,
  [in] BSTR             Character,
  [in] long             CursorMode
);

Parameters

Cursor [in]

The IInkCursor object that generated the SystemGesture event.

Id [in]

The value of the system gesture.

X [in]

The x-coordinate of the location of the gesture.

Y [in]

The y-coordinate of the location of the gesture.

Modifier [in]

Reserved.

Character [in]

Reserved.

CursorMode [in]

A value that indicates whether the IInkCursor object is in normal mode or eraser mode. 1 is for normal mode and 2 are for eraser mode.

Return value

This event does not return a value.

Remarks

System gestures give information about the IInkCursor object that is being used to create the gesture. They also provide shortcuts to combinations of mouse events and are ways to detect mouse events with less impact on performance.

For example, instead of looking for a MouseUp Event [InkPicture Control]/MouseDown Event [InkPicture Control] pair of events with no other mouse events occurring in between, you can look for the Tap or RightTap system gestures.

As another example, instead of listening for MouseDown Event [InkPicture Control]/MouseMove Event [InkPicture Control] events and getting numerous MouseMove Event [InkPicture Control] messages, you can watch for the Drag or RightDrag system gestures as long as you're not interested in the (x, y) coordinates of every position of the mouse. This allows you to receive only one message instead of numerous MouseMove Event [InkPicture Control] messages.

For a list of specific system gestures, see the InkSystemGesture enumeration type. For more information about system gestures, see Using Gestures and Command Input on the Tablet PC.

This event method is defined in the _IInkCollectorEvents, _IInkOverlayEvents, and _IInkPictureEvents dispatch-only interfaces (dispinterfaces) with an ID of DISPID_ICESystemGesture.

Requirements

Requirement Value
Minimum supported client
Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
None supported
Header
Msinkaut.h (also requires Msinkaut_i.c)
Library
InkObj.dll

See also

InkPicture

InkSystemGesture Enumeration

Using Gestures