InkPicture.Gesture 事件

發生于辨識應用程式特定的 手勢 時。

語法

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

參數

資料指標 [in]

產生Gesture事件的IInkCursor物件。

筆劃 [in]

辨識器以手勢傳回的 IInkStrokes 集合。

手勢 [in]

從辨識器信賴度排序的 IInkGesture 物件陣列。

如需 VARIANT 結構的詳細資訊，請參閱 使用 COM 程式庫。

取消 [in， out]

VARIANT_TRUE 是否應該取消此事件，例如不要清除筆跡並引發 Stroke 事件。 否則， VARIANT_FALSE。

傳回值

此事件不會傳回值。

備註

這個事件方法定義在識別碼為 DISPID_ICEGesture 的 _IInkCollectorEvents、 _IInkOverlayEvents和 _IInkPictureEvents 僅分派介面 (散發介面) 。

當 CollectionMode 屬性設定為 GestureOnly時，當使用者新增筆勢時和 Gesture 事件發生之間的逾時，是您無法以程式設計方式改變的固定值。 筆勢辨識在 InkAndGesture 模式中較快。

若要防止 在 InkAndGesture 模式中收集筆跡：

• 將 CollectionMode 設定為 InkAndGesture。
• 刪除 Stroke 事件中的 筆劃 。
• 處理 Gesture 事件中的手勢。

若要防止筆跡在進行時流動，請將 DynamicRendering 屬性設定為 FALSE。

除了插入筆跡時，在選取或清除模式中引發 Gesture 事件。 您必須負責追蹤編輯模式，而且在解譯事件之前應注意模式。

注意

若要辨識手勢，您必須使用可以收集筆跡的物件或控制項。

應用程式手勢會定義為應用程式內支援的手勢。

若要發生此事件，物件或控制項必須對一組應用程式手勢感興趣。 若要設定物件或控制項對一組手勢感興趣，請呼叫物件或控制項的 SetGestureStatus 方法。

如需特定應用程式手勢的清單，請參閱 InkApplicationGesture 列舉類型。

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	Msinkaut.h (也需要 Msinkaut_i.c)
程式庫	InkObj.dll

另請參閱

InkPicture

InkApplicationGesture 列舉

SetGestureStatus 方法

使用手勢