InputHapticsManager 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
若該裝置支援觸覺且最近收到輸入，則提供觸發觸覺回饋的功能。 物件必須在與其建立時相同的執行緒中使用。
public ref class InputHapticsManager sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class InputHapticsManager final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 1245184)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Experimental]
class InputHapticsManager final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1245184)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class InputHapticsManager[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 1245184)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Experimental]
public sealed class InputHapticsManagerPublic NotInheritable Class InputHapticsManager- 繼承
- 屬性
Windows 需求
| 規格需求 | Description |
|---|---|
| 裝置系列 |
Windows 11, version 24H2 (已於 10.0.26100.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v19.0 引進)
|
範例
以下範例展示了如何在最近將輸入傳送到當前執行緒的輸入裝置上觸發觸覺波形。 若不支援該波形，將第二個參數 0 傳送，系統可使用特定裝置類型的備援。 範例也處理了 API 無法取得或不支援的情況。
bool SendHapticFeedback(uint16_t waveform)
{
auto hapticsManagerStatics = winrt::try_get_activation_factory<
winrt::InputHapticsManager, winrt::IInputHapticsManagerStatics>();
if (hapticsManagerStatics && hapticsManagerStatics.IsSupported())
{
return hapticsManagerStatics
.GetForCurrentThread()
.TrySendHapticWaveform(waveform, 0);
}
return false;
}
屬性
| 名稱 | Description |
|---|---|
| CurrentDeviceType |
若該裝置支援觸覺且最近收到輸入，則提供觸發觸覺回饋的功能。 物件必須在與其建立時相同的執行緒中使用。 |
| CurrentHapticsController |
取得最近將輸入傳送到執行緒的輸入裝置的 SimpleHapticsController 物件（若有覆蓋時則由 SetOverrideHapticsController 設定的控制器）。 |
| CurrentHapticsControllerDeviceType |
取得最近一次由執行緒接收輸入的輸入裝置的觸覺裝置類型（若有覆蓋，則由 SetOverrideHapticsController 設定的裝置類型）。 |
| ThreadId |
取得擁有這個 InputHapticsManager 物件的執行緒的 ID。 |