次の方法で共有

InkOverlay.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]

インクを消去しない、 Stroke イベントを発生させるなど、このジェスチャのコレクションを取り消す必要があるかどうか。

戻り値

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

解説

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

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

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

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

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

Note

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

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

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

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

要件

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

関連項目

InkOverlay クラス

InkApplicationGesture 列挙

SetGestureStatus メソッド

ジェスチャの使用