InkCollector.Gesture イベント

  • [アーティクル]

アプリケーション固有のジェスチャが認識されたときに発生します。

構文

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

パラメーター

Cursor [in]

Gesture イベントを生成した IInkCursor オブジェクト。

ストローク [入力]

認識エンジンがジェスチャとして返した IInkStrokes コレクション。

ジェスチャ [入力]

認識エンジンからの信頼度の順に、 IInkGesture オブジェクトの配列。

VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。

Cancel [in, out]

この ジェスチャを取り消す必要があるかどうかをVARIANT_TRUEします。それ以外の場合 は、VARIANT_FALSE。

戻り値

このイベントは値を返しません。

解説

このイベント メソッドは、DISPID_ICEGestureの ID を持つディスパッチ専用インターフェイス (ディスパッチ インターフェイス) _IInkCollectorEvents、_IInkOverlayEvents、および_IInkPictureEventsで定義されます。

CollectionMode プロパティが GestureOnly に設定されている場合、ユーザーがジェスチャを追加してから Gesture イベントが発生したときのタイムアウトは、プログラムで変更できない固定値です。 InkAndGesture モードでは、ジェスチャ認識が高速になります。

InkAndGesture モードの間にインクの収集を防ぐには、次の手順を実行します。

  • CollectionMode を InkAndGesture に設定します。
  • Stroke イベントでストロークを削除します。
  • ジェスチャ イベントでジェスチャを処理します。

ゲスチャリング中にインクが流れないようにするには、 DynamicRendering プロパティを FALSE に設定します。

インクの挿入時に加えて、選択モードまたは消去モードのときに Gesture イベントが発生します。 編集モードを追跡する必要があり、イベントを解釈する前にモードに注意する必要があります。

注意

ジェスチャを認識するには、インクを収集できるオブジェクトまたはコントロールを使用する必要があります。

アプリケーション ジェスチャは、アプリケーション内でサポートされるジェスチャとして定義されます。

このイベントを発生させるには、オブジェクトまたはコントロールが一連のアプリケーション ジェスチャに関心を持っている必要があります。 一連のジェスチャに対してオブジェクトまたはコントロールの関心を設定するには、オブジェクトまたはコントロールの SetGestureStatus メソッドを呼び出します。

特定のアプリケーション ジェスチャの一覧については、 InkApplicationGesture 列挙の種類に関するページを参照してください。

必要条件

要件 値
サポートされている最小のクライアント
 Windows XP Tablet PC Edition [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
Header
Msinkaut.h (Msinkaut_i.c も必要)
ライブラリ
InkObj.dll

関連項目

InkCollector クラス

InkApplicationGesture 列挙

SetGestureStatus メソッド

ジェスチャの使用