Control.RemoveFocusEngagement 方法

定义

命名空间:

Windows.UI.Xaml.Controls

为游戏板/远程交互) 具有焦点参与 (的控件释放控件边界的焦点。

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;

void RemoveFocusEngagement();

public void RemoveFocusEngagement();

function removeFocusEngagement()

Public Sub RemoveFocusEngagement ()

Windows 要求

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

注解

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

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

有关详细信息，请参阅 Xbox 和电视设计文章的焦点参与部分。

版本兼容性

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

若要避免应用在以前版本的 Windows 10 上运行时出现异常，请勿在不首先执行运行时检查的情况下调用此方法。 此示例演示如何使用 ApiInformation 类在使用此方法之前检查此方法是否存在。

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}