Occurs when an application gesture is recognized.
HRESULT Gesture( [in] IInkCursor *Cursor, [in] IInkStrokes *Strokes, [in] VARIANT Gestures, [in, out] VARIANT_BOOL *Cancel );
The IInkCursor object that was used to create this gesture.
An array of IInkGesture objects, in order of confidence.
For more information about the VARIANT structure, see Using the COM Library.
Cancel [in, out]
If this event succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
This event method is defined in the _IInkEditEvents interface. The _IInkEditEvents interface implements the IDispatch interface with an identifier of DISPID_IeeGesture.
A Gesture event is raised only if the IInkStrokeDisp for the IInkGesture object is the first IInkStrokeDisp object since the last call to the Recognize method or the last firing of the recognition timeout.
For a list of application gestures, see the InkApplicationGesture enumeration type.
The InkEdit control does not recognize multiple stroke gestures.
The InkEdit control subscribes to the following gestures.
To alter the default action for a gesture:
- Add event handlers for the Gesture and Stroke events.
- In the Gesture event handler, cancel the Gesture event for the gesture, and perform the alternate action for the gesture.
- In the Stroke event handler, cancel the Stroke event for the IInkStrokeDisp object that raised the canceled Gesture event.
|Minimum supported client
||Windows XP Tablet PC Edition [desktop apps only]
|Minimum supported server