Export (0) Print
Expand All
Expand Minimize

InkOverlay.SystemGesture event

Applies to: desktop apps only

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 are useful because they 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 "cheaper" ways to detect mouse events.

For example, instead of looking for a MouseUp Event / MouseDown Event 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 / MouseMove Event events and getting numerous MouseMove Event 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 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

Minimum supported client

Windows XP Tablet PC Edition

Minimum supported server

None supported

Header

Msinkaut.h (also requires Msinkaut_i.c)

Library

InkObj.dll

See also

InkOverlay Class
InkSystemGesture Enumeration
IInkCursor Interface
Using Gestures
Pen Input, Ink, and Recognition
Command Input on the Tablet PC

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2015 Microsoft