Control.RequiresPointer 屬性
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得或設定 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"/>
屬性值
指標模擬模式。 預設值為 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;
}