次の方法で共有

Recognizer プラグイン

  • [アーティクル]

認識エンジン プラグインは、ジェスチャ、手書き、またはその他のオブジェクトのタブレット ペンの動きを監視するオブジェクトです。

システム ジェスチャ

RealTimeStylus オブジェクトは、システム ジェスチャを認識します。 RealTimeStylus オブジェクトは、ジェスチャを完了するデータ (SystemGesture の StylusUpData オブジェクトなど) に応答して、SystemGestureData オブジェクトを StylusQueues キューに追加します。 詳細については、「 プラグイン データ」と「RealTimeStylus クラス」を参照してください。

GestureRecognizer オブジェクト

GestureRecognizer オブジェクトは、IStylusSyncPlugin インターフェイスと IStylusAsyncPlugin インターフェイスを実装します。 GestureRecognizer オブジェクトは、アプリケーション ジェスチャを認識します。 内部的には、 GestureRecognizer オブジェクトは、Microsoft ジェスチャ認識エンジンを使用してジェスチャ認識を実行します。

GestureRecognizer オブジェクトがジェスチャを認識すると、ストロークの StylusUpData オブジェクトに応答して、StylusQueues キューにカスタム スタイラス データが追加されます。 CustomStylusData オブジェクトの CustomDataId プロパティは GestureRecognitionDataGuid 値に設定され、CustomStylusData オブジェクトの Data プロパティには GestureRecognitionData オブジェクトが含まれています。

次の図は、 GestureRecognizer オブジェクトがタブレット ペン データにデータを追加する方法を示しています。

ジェスチャレコグナイザーのデータ フローの図

この図では、"SD" という円が StylusDownData オブジェクトを表し、"P" という文字が付いた円は、RealTimeStylus オブジェクトの出力キューに既に追加されており、非同期プラグイン コレクションにまだ送信されていない PacketsData オブジェクトを表します。 "SU" という円は、RealTimeStylus オブジェクトが現在処理している StylusUpData オブジェクトを表します。 同期プラグイン コレクションに送信され、出力キューに配置されます。 "GR" という文字が付いた円は、"SU" に関連付けられたスタイラスアップ通知に応答して GestureRecognizer プラグインによって入力キューに追加されるカスタム スタイラス データを表します。 次に、"GR" という文字が付いたカスタム スタイラス データが同期プラグインに渡され、次に出力キューに渡されてから、次のタブレット ペン データが処理されます。 空の円は、将来のタブレット ペン データが追加される出力キュー内の位置を表します。

既定では、 GestureRecognizer オブジェクトは単一ストロークジェスチャのみを認識します。ただし、 GestureRecognizer オブジェクトは、マルチストローク ジェスチャを認識するように設定できます。 マルチストローク ジェスチャの場合、CustomStylusData オブジェクトは、ジェスチャの最後のストロークの StylusUpData オブジェクトに応答して StylusQueues キューに追加されます。 マルチストローク ジェスチャを認識すると、ストロークのセットが重複する通知を受け取る場合があります。 例えば、1回目と2回目のストロークをまとめて1つのジェスチャとして認識し、2番目のストロークを単独でジェスチャとして認識してもよい。 マルチストローク ジェスチャ認識の詳細については、 GestureRecognizer クラスと MaxStrokeCount プロパティを参照してください。

Multistroke ジェスチャ認識に GestureRecognizer オブジェクトを使用している場合は、カスケードされた RealTimeStylus モデルを使用し、 GestureRecognizer オブジェクトをセカンダリ RealTimeStylus オブジェクトにアタッチすることで、最適なパフォーマンスを実現できます。 カスケード RealTimeStylus モデルの詳細については、「 カスケードされた RealTimeStylus モデル」を参照してください。

特別な考慮事項

次の一覧では、 GestureRecognizer オブジェクトを使用するときに考慮すべきその他の点について説明します。

カスタム ジェスチャ認識

次の方法で、手書き、ジェスチャ、またはその他のオブジェクトを認識するカスタム認識エンジン プラグインを作成できます。

  • ストローク情報を既存の Recognizer オブジェクトに渡し、 AddCustomStylusDataToQueue メソッドを使用してタブレット ペン データ ストリームに結果を追加します。
  • プラグイン内で認識を実行し、 AddCustomStylusDataToQueue メソッドを使用して結果をタブレット ペン データ ストリームに追加します。

アプリケーション ジェスチャ

システム ジェスチャ

マウス メッセージとシステム イベントのタイムライン