InkCollector.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;否則,VARIANT_FALSE

傳回值

此事件不會傳回值。

備註

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

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

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

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

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

注意

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

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

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

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

規格需求

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

另請參閱

InkCollector 類別

InkApplicationGesture 列舉

SetGestureStatus 方法

使用手勢