Control.IsFocusEngaged 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

获取或设置一个值，该值指示焦点是否在游戏板/远程交互) (控件边界内受到限制。

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

bool IsFocusEngaged();

void IsFocusEngaged(bool value);

public bool IsFocusEngaged { get; set; }

var boolean = control.isFocusEngaged;
control.isFocusEngaged = boolean;

Public Property IsFocusEngaged As Boolean

<control IsFocusEngaged="bool"/>

bool

如果焦点在控件边界内受到限制，则为 true;否则为 false。

设备系列	Windows 10 Anniversary Edition (在 10.0.14393.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v3.0 中引入)

IsFocusEngagementEnabled 必须为 true ，并且控件必须具有焦点，然后才能将 IsFocusEngaged 属性设置为 true。否则，将发生运行时异常。

通过焦点参与，可以更轻松地使用游戏板或遥控器与应用交互。设置焦点占用不会影响键盘或其他输入设备。

当 IsFocusEngagementEnabled 属性设置为 true 时，它会将控件标记为需要焦点占用。这意味着用户必须按“A/选择”按钮来“占用”该控件并与其交互。完成后，他们可以按 B/后退按钮以脱离控件并导航离开控件。

有关此属性的详细信息，请参阅针对 Xbox 和电视进行设计一文的焦点参与部分。

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

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

if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "IsFocusEngaged"))
{
    slider1.IsFocusEngaged = true;
}