InkPicture.Gesture 事件

在识别特定于应用程序的 手势 时发生。

语法

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

参数

光标 [in]

生成手势事件的 IInkCursor 对象。

笔划 [in]

识别器作为手势返回的 IInkStrokes 集合。

手势 [in]

识别器中的 IInkGesture 对象的数组（按置信度顺序排列）。

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

取消 [in， out]

VARIANT_TRUE 是否应取消此事件，例如不擦除墨迹并触发 Stroke 事件。 否则， VARIANT_FALSE。

返回值

此事件不返回值。

备注

此事件方法在 ID 为 DISPID_ICEGesture 的 _IInkCollectorEvents、_IInkOverlayEvents 和 _IInkPictureEvents 仅调度接口 (dispinterface) 中定义。

当 CollectionMode 属性设置为 GestureOnly 时，用户添加手势和 手势 事件发生之间的超时是一个无法以编程方式更改的固定值。 在 InkAndGesture 模式下，手势识别速度更快。

若要防止在 InkAndGesture 模式下收集墨迹 ，请执行以下操作：

• 将 CollectionMode 设置为 InkAndGesture。
• 删除 Stroke 事件中的笔 划 。
• 处理手势事件中的 手势 。

若要防止墨迹在做手势时流动，请将 DynamicRendering 属性设置为 FALSE。

除了插入墨迹时，在选择或擦除模式下还会触发 手势 事件。 你负责跟踪编辑模式，在解释事件之前应了解该模式。

注意

若要识别手势，必须使用可以收集墨迹的对象或控件。

应用程序手势定义为应用程序中支持的手势。

若要发生此事件，对象或控件必须对一组应用程序手势感兴趣。 若要在一组手势中设置对象或控件的兴趣，请调用对象或控件的 SetGestureStatus 方法。

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

要求

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

另请参阅

InkPicture

InkApplicationGesture 枚举

SetGestureStatus 方法

使用手势