InkEdit.Gesture イベント
アプリケーション ジェスチャが認識されたときに発生します。
構文
HRESULT Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
パラメーター
-
Cursor [in]
-
このジェスチャの作成に使用された IInkCursor オブジェクト。
-
ストローク [入力]
-
このジェスチャを構成する IInkStrokeDisp オブジェクトを含む InkStrokes コレクション。
-
ジェスチャ [入力]
-
信頼度の順に IInkGesture オブジェクトの配列。
VARIANT 構造体の詳細については、「 COM ライブラリの使用」を参照してください。
-
Cancel [in, out]
-
インクを消去したり Stroke イベントを発生させたりしないように、このジェスチャを構成する InkStrokes コレクションを取り消す必要があるかどうか。
戻り値
このイベントが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。
解説
このイベント メソッドは、 _IInkEditEvents インターフェイスで定義されます。 _IInkEditEvents インターフェイスは、DISPID_IeeGestureの識別子を持つ IDispatch インターフェイスを実装します。
Gesture イベントが発生するのは、IInkGesture オブジェクトの IInkStrokeDisp が Recognize メソッドの最後の呼び出し以降の最初の IInkStrokeDisp オブジェクトである場合、または認識タイムアウトが最後に発生した場合のみです。
Gesture イベントが取り消された場合、Gesture イベントを発生させた InkStrokes コレクションに対して Stroke イベントが発生します。
このイベントを発生させるには、 InkEdit コントロールが一連のアプリケーション ジェスチャをサブスクライブする必要があります。 一連のジェスチャに InkEdit コントロールの関心を設定するには、 SetGestureStatus メソッドを呼び出します。
アプリケーション ジェスチャの一覧については、 InkApplicationGesture 列挙の種類に関するページを参照してください。
InkEdit コントロールは、複数のストローク ジェスチャを認識しません。
InkEdit コントロールは、次のジェスチャをサブスクライブします。
| ジェスチャ | アクション |
|---|---|
| 左下、下-左-長 |
Enter |
| Right |
Space |
| 左 |
バックスペース |
| Up-right、Up-right-long |
タブ |
ジェスチャの既定のアクションを変更するには:
- Gesture イベントと Stroke イベントのイベント ハンドラーを追加します。
- Gesture イベント ハンドラーで、ジェスチャの Gesture イベントを取り消し、ジェスチャの代替アクションを実行します。
- Stroke イベント ハンドラーで、取り消された Gesture イベントを発生させた IInkStrokeDisp オブジェクトの Stroke イベントを取り消します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| ヘッダー |
|
| ライブラリ |
|