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
Left	退格鍵
右上、右-長	索引標籤

若要改變手勢的預設動作：

1. 新增 Gesture 和 Stroke 事件的事件處理常式。
2. 在 Gesture 事件處理常式中，取消手勢的 Gesture 事件，並執行筆勢的替代動作。
3. 在Stroke事件處理常式中，取消引發已取消Gesture事件的IInkStrokeDisp物件的Stroke事件。

規格需求

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

另請參閱

InkEdit

InkApplicationGesture 列舉

SetGestureStatus 方法 [InkEdit 控制項]

RecoTimeout 屬性

Stroke 事件 [InkEdit 控制項]

使用手勢