Control.RequiresPointer 屬性

  • 參考

定義

命名空間:
Windows.UI.Xaml.Controls
編輯

取得或設定 UI 元素是否支援滑鼠模式，以模擬非指標輸入裝置的指標互動體驗，例如遊戲台或遠端控制。

public:
 property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };
RequiresPointer RequiresPointer();

void RequiresPointer(RequiresPointer value);
public RequiresPointer RequiresPointer { get; set; }
var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;
Public Property RequiresPointer As RequiresPointer
<control RequiresPointer="requiresPointerMemberName"/>

屬性值

RequiresPointer

指標模擬模式。 預設值為 Never。

Windows 需求

裝置系列
Windows 10 Anniversary Edition (已於 10.0.14393.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v3.0 引進)

備註

對於非指標輸入裝置，焦點會透過各種方法在控制項之間移動，例如鍵盤上的 Tab 鍵和方向鍵、方向板 (D 鍵) ，或遊戲控制器上的搖桿。 對於某些使用者體驗，例如地圖和繪圖介面，無法使用 XY 焦點流覽或實際使用。 RequiresPointer 可讓應用程式透過游標提供更類似指標的互動體驗，這些游標可以使用遊戲輸入裝置自由移動。

RequiresPointer 僅在 Xbox 裝置系列上受到支援，而且只有在使用遊戲台或遠端控制時才支援。 否則會忽略 屬性。

RequiresPointerMode 會在應用層級設定滑鼠模式。

如需詳細資訊，請參閱設計 Xbox 和電視的滑鼠模式一節。

版本相容性

在 Windows 10 1607 版之前，無法使用 RequiresPointer 屬性。 如果您的 App 在 Microsoft Visual Studio 中的「最低平臺版本」設定小於此頁面稍後的 [需求] 區塊中顯示的「引進版本」，您必須設計並測試您的應用程式以考慮此設定。 如需詳細資訊，請參閱 版本調適型程式碼。

若要避免在舊版Windows 10上執行應用程式時發生例外狀況，請勿在 XAML 中設定此屬性，或在不執行執行時間檢查的情況下使用它。 此範例示範如何使用 ApiInformation 類別，在設定此屬性之前檢查此屬性是否存在。

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
    mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}

適用於

另請參閱