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();
}