[一部の情報は、商用リリース前に大幅に変更される可能性があるプレリリース製品に関連しています。 Microsoftは、ここに記載されている情報に関して明示または黙示を問わず、一切の保証を行いません。
GestureRecognizer によって返される表示に依存しないピクセルではなく、デバイスに対して単位で返される出力を使用して、ポインター入力に対してジェスチャ認識を実行します。 これらの出力ユニットは、ディスプレイではなくタッチパッド自体に対してジェスチャを認識できるように、タッチパッド入力に適しています。
ポインター入力が認識エンジンに供給されると、アクティブになります。 入力操作が完了するまでアクティブなままです。これは、すべての連絡先に対して逸脱した入力を供給するか、 CompleteGesture() を介して強制的に完了することによって行います。
すべての API は GestureRecognizer の対応する API と同じように機能します。 唯一の違いは、ジェスチャ イベントを介して公開される認識された出力の座標空間です。
Namespace: Windows。Ui。入力
Members
コンストラクター
PhysicalGestureRecognizer();
PhysicalGestureRecognizer ランタイムクラスの新しいインスタンスを返します。
プロパティ
IsActive
Boolean IsActive { get; }
入力操作がまだ処理されているかどうかを返します。
GestureSettings
Windows.UI.Input.GestureSettings GestureSettings;
認識用に構成されているジェスチャを取得または設定します。 PhysicalGestureRecognizer では、次のジェスチャのサブセットがサポートされています。
- タップ
- Hold
- ManipulationTranslate[Rails][X,Y]
- ManipulationRotate
- ManipulationScale
- ManipulationMultipleFingerPanning
タッチパッド入力は、これらのジェスチャを実行できなくなったシナリオでのみ受信されるため、タッチパッド入力はタップまたはホールドとして認識されません。
TapMinContactCount
UInt32 TapMinContactCount;
タップを認識するために必要な連絡先の最小数を取得または設定します。
TapMaxContactCount
UInt32 TapMaxContactCount;
タップを認識するために必要な連絡先の最大数を取得または設定します。
HoldMinContactCount
UInt32 HoldMinContactCount;
保留リストを認識するために必要な連絡先の最小数を取得または設定します。
HoldMaxContactCount
UInt32 HoldMaxContactCount;
保留リストを認識するために必要な連絡先の最大数を取得または設定します。
HoldRadius
Single HoldRadius;
タップまたはホールドを認識するために、連絡先が元の下の場所から留まる必要がある半径を取得または設定します。
HoldStartDelay
Windows.Foundation.TimeSpan HoldStartDelay;
保留が認識されるまでに連絡先を停止する必要がある時間を取得または設定します。 連絡先の継続時間が出発時にこの値より短く、 HoldRadius より長く移動していない場合は、タップが認識されます。
TranslationMinContactCount
UInt32 TranslationMinContactCount;
翻訳を認識するために必要な連絡先の最小数を取得または設定します。
TranslationMaxContactCount
UInt32 TranslationMaxContactCount;
翻訳を認識するために必要な連絡先の最大数を取得または設定します。
メソッド
ProcessDownEvent、ProcessMoveEvents、ProcessUpEvent
void ProcessDownEvent(Windows.UI.Input.PointerPoint value);
void ProcessMoveEvents(IVector<Windows.UI.Input.PointerPoint> value);
void ProcessUpEvent(Windows.UI.Input.PointerPoint value);
ジェスチャ認識のために、指定されたポインター入力を PhysicalGestureRecognizer にフィードします。
CompleteGesture
void CompleteGesture();
後続の入力が新しいジェスチャとして扱われるように、現在の操作を完了します。 ジェスチャが現在進行中の場合は、完了のイベントがトリガーされます。
イベント
操作開始
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;
PhysicalGestureRecognizer が操作の認識を開始したときにトリガーされます。
ManipulationUpdated
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;
PhysicalGestureRecognizer が操作中に更新された入力を受け取ったときにトリガーされます。
ManipulationCompleted（操作完了）
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;
PhysicalGestureRecognizer が操作の認識を完了したときにトリガーされます。
タップされた
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.TappedEventArgs> Tapped;
PhysicalGestureRecognizer がタップを認識したときにトリガーされます。
保持
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.HoldingEventArgs> Holding;
PhysicalGestureRecognizer が保留ジェスチャを認識したときにトリガーされます。
必要条件
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 11 |
| 名前空間 | Windows。Ui。入力 |
| API コントラクト | Windows。Foundation.UniversalApiContract (バージョン 19) |
| IID | IPhysicalGestureRecognizer: 79a29f4d-32a6-5aa5-a999-42b0b420c66d |