[部分資訊涉及預售產品，可能在商業發行前經過大幅修改。 Microsoft 對此處提供的資訊不作明示或暗示的任何保證。]
對輸入的指標進行手勢辨識，輸出以相對於裝置的單位回傳，而非 GestureRecognizer 回傳的顯示無關像素。 這些輸出單元更適合觸控板輸入，讓手勢相較於觸控板本身而非顯示器來辨識。
一旦指標輸入輸入到識別器，它就會啟動。 它會持續運作直到輸入互動完成——無論是將離開的輸入餵給所有聯絡人，還是透過 CompleteGesture（） 強制完成。
所有 API 的運作方式與 GestureRecognizer 中的對應版本相同。 唯一的差別是透過手勢事件暴露的識別輸出座標空間。
命名空間： Windows。UI。輸入
成員
Constructor
PhysicalGestureRecognizer();
回傳一個新的 PhysicalGestureRecognizer 執行類別實例。
屬性
IsActive
Boolean IsActive { get; }
回傳輸入互動是否仍在處理中。
手勢設定
Windows.UI.Input.GestureSettings GestureSettings;
取得或設定那些設定為識別的手勢。 PhysicalGestureCognir 支援以下手勢子集：
- 敲擊
- 保留
- 操控翻譯[軌跡][X，Y]
- 操作旋轉
- 操控尺度
- 操作多指平移
觸控板輸入永遠不會被識別為點擊或按住，因為觸控板輸入只會在無法執行這些手勢的情況下接收。
TapMinContactCount
UInt32 TapMinContactCount;
取得或設定竊聽器識別所需的最少聯絡數量。
TapMax聯絡計數
UInt32 TapMaxContactCount;
取得或設定竊聽器識別所需的最大聯絡點數。
保持最小聯絡計數
UInt32 HoldMinContactCount;
取得或設定最低聯絡數量以保證保留。
保持最大聯絡計數
UInt32 HoldMaxContactCount;
取得或設定保留被識別所需的最大聯絡人數。
保持半徑
Single HoldRadius;
取得或設定聯絡人必須保持在原始下行位置的半徑內，才能識別點擊或按鍵。
HoldStartDelay
Windows.Foundation.TimeSpan HoldStartDelay;
設定聯絡人必須在等待狀態下達的時間長短，才能被識別為等待。 若聯絡結束時持續時間少於此值，且未超過 保持半徑，則為輕觸。
翻譯最小聯絡計數
UInt32 TranslationMinContactCount;
取得或設定翻譯被識別所需的最少聯絡數量。
翻譯：MaxContactCount
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 進行手勢識別。
完成手勢
void CompleteGesture();
完成當前互動，使後續輸入被視為新的手勢。 如果手勢正在進行中，會觸發完成該手勢的事件。
活動
操作已開始
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationStartedEventArgs> ManipulationStarted;
當 PhysicalGestureRecognitionr 開始辨識操作行為時觸發。
操作已更新
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationUpdatedEventArgs> ManipulationUpdated;
當 物理手勢識別器 在操作過程中接收到更新的輸入時會觸發。
操作已完成
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.ManipulationCompletedEventArgs> ManipulationCompleted;
當 物理手勢識別 器完成辨識操作時觸發。
點頭
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.TappedEventArgs> Tapped;
當 PhysicalGestureRecognitionr 識別到點擊時會觸發。
持有
event Windows.Foundation.TypedEventHandler<
PhysicalGestureRecognizer,
Windows.UI.Input.HoldingEventArgs> Holding;
當 PhysicalGestureRecognitionr 識別到保持手勢時會觸發。
要求
| 需求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 11 |
| 命名空間 | Windows。UI。輸入 |
| API 合約 | Windows。Foundation.UniversalApiContract（版本 19） |
| IID | IPhysicalGestureRecognizer：79a29f4d-32a6-5aa5-a999-42b0b420c66d |