Control.RemoveFocusEngagement Метод

Определение

Освобождает фокус от границ элемента управления для элемента управления, который включает фокус (для игровой площадки или удаленного взаимодействия).

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/Back, чтобы отключить элемент управления и уйти от него. Вы можете вызвать RemoveFocusEngagement, чтобы программно отключить элемент управления.

Дополнительные сведения см. в разделе Фокусировка в статье Проектирование для Xbox и ТВ .

Совместимость версий

Метод RemoveFocusEngagement недоступен до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше значения "введенной версии", показанной в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Адаптивный к версии код.

Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не вызывайте этот метод без предварительного выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого метода перед его использованием.

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

Применяется к