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 键和箭头键、遥控器上的方向键 (方向键) 或游戏控制器上的拇指杆。 对于某些用户体验（如地图和绘图图面），使用 XY 焦点导航是不可能或不切实际的。 RequiresPointer 使应用能够通过可使用游戏输入设备自由移动的光标提供更类似于指针的交互体验。

RequiresPointer 仅在 Xbox 设备系列上受支持，并且仅在使用游戏板或遥控器时受支持。 否则，将忽略 属性。

RequiresPointerMode 在应用程序级别设置鼠标模式。

有关详细信息，请参阅针对 Xbox 和电视进行设计的鼠标模式部分。

版本兼容性

在 Windows 10 版本 1607 之前，RequiresPointer 属性不可用。 如果 Microsoft Visual Studio 中应用的“最低平台版本”设置小于本页稍后的“要求”块中显示的“引入版本”，则必须设计和测试应用以考虑到这一点。 有关详细信息，请参阅 版本自适应代码。

若要避免在以前版本的 Windows 10 上运行应用时出现异常，请不要在 XAML 中设置此属性或在未执行运行时检查的情况下使用它。 此示例演示如何使用 ApiInformation 类在设置此属性之前检查此属性是否存在。

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

另请参阅

• RequiresPointerMode