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 |
|
| ライブラリ |
|