InkEdit.Gesture 事件

在识别应用程序手势时发生。

语法

HRESULT Gesture(
  [in]      IInkCursor   *Cursor,
  [in]      IInkStrokes  *Strokes,
  [in]      VARIANT      Gestures,
  [in, out] VARIANT_BOOL *Cancel
);

参数

光标 [in]

用于创建此手势的 IInkCursor 对象。

笔划 [in]

InkStrokes 集合，其中包含构成此手势的 IInkStrokeDisp 对象。

手势 [in]

IInkGesture 对象的数组，按置信度顺序排列。

有关 VARIANT 结构的详细信息，请参阅 使用 COM 库。

取消 [in， out]

是否应取消构成此手势的 InkStrokes 集合，以免擦除墨迹并触发 Stroke 事件。

返回值

如果此事件成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

备注

此事件方法在 _IInkEditEvents 接口中定义。 _IInkEditEvents 接口实现标识符为 DISPID_IeeGesture 的 IDispatch 接口。

仅当 IInkGesture 对象的 IInkStrokeDisp 是自上次调用 Recognize 方法或上次触发识别超时以来的第一个 IInkStrokeDisp 对象时，才会引发 Gesture 事件。

如果取消 Gesture 事件，则会为引发 Gesture 事件的 InkStrokes 集合引发 Stroke 事件。

若要发生此事件， InkEdit 控件必须订阅一组应用程序手势。 若要设置 InkEdit 控件对一组手势的兴趣，请调用 SetGestureStatus 方法。

有关应用程序手势的列表，请参阅 InkApplicationGesture 枚举类型。

InkEdit 控件无法识别多个笔划手势。

InkEdit 控件订阅以下手势。

手势	操作
左下、左下-长	Enter
Right	Space
左	Backspace
向上向右，向上向右长	Tab

若要更改笔势的默认操作，请执行以下操作：

1. 为 笔势 和 笔划 事件添加事件处理程序。
2. 在 手势 事件处理程序中，取消 笔势的手势 事件，并为该手势执行备用操作。
3. 在 Stroke 事件处理程序中，取消引发取消手势事件的 IInkStrokeDisp 对象的 Stroke 事件。

要求

要求	值
最低受支持的客户端	Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器	无受支持的版本
标头	Inked.h (还需要 inked_i.c)
库	InkEd.dll

另请参阅

InkEdit

InkApplicationGesture 枚举

SetGestureStatus 方法 [InkEdit 控件]

RecoTimeout 属性

笔划事件 [InkEdit 控件]

使用手势