Control.FocusDisengaged Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит при снятии фокуса с границ элемента управления (для игровой площадки или удаленного взаимодействия).
// Register
event_token FocusDisengaged(TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;
// Revoke with event_token
void FocusDisengaged(event_token const* cookie) const;
// Revoke with event_revoker
Control::FocusDisengaged_revoker FocusDisengaged(auto_revoke_t, TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;
public event TypedEventHandler<Control,FocusDisengagedEventArgs> FocusDisengaged;
function onFocusDisengaged(eventArgs) { /* Your code */ }
control.addEventListener("focusdisengaged", onFocusDisengaged);
control.removeEventListener("focusdisengaged", onFocusDisengaged);
- or -
control.onfocusdisengaged = onFocusDisengaged;
Public Custom Event FocusDisengaged As TypedEventHandler(Of Control, FocusDisengagedEventArgs)
<control FocusDisengaged="eventhandler"/>
Тип события
Требования к Windows
Семейство устройств |
Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v3.0)
|
Комментарии
Сведения о событиях см. в разделе FocusDisengagedEventArgs.
Фокусировка упрощает использование игровой площадки или пульта дистанционного управления для взаимодействия с приложением. Настройка задействования фокуса не влияет на клавиатуру или другие устройства ввода.
Если свойству IsFocusEngagementEnabled присвоено значение true, элемент управления помечается как требующий задействования фокуса. Это означает, что пользователь должен нажать кнопку A/выбор, чтобы включить элемент управления и начать с ним взаимодействовать. По завершении они могут нажать кнопку B/Back, чтобы отключить элемент управления и уйти от него.
Дополнительные сведения см. в разделе Фокусировка в статье Проектирование для Xbox и ТВ .
Совместимость версий
Событие FocusDisengaged недоступно до Windows 10 версии 1607. Если параметр "минимальная версия платформы" вашего приложения в Microsoft Visual Studio меньше значения "введенной версии", показанной в блоке "Требования" далее на этой странице, необходимо разработать и протестировать приложение, чтобы учесть это. Дополнительные сведения см. в разделе Адаптивный к версии код.
Чтобы избежать исключений при запуске приложения в предыдущих версиях Windows 10, не подключайте это событие без предварительного выполнения проверка среды выполнения. В этом примере показано, как использовать класс ApiInformation для проверка наличия этого события перед его использованием.
<Slider x:Name="slider1" Loaded="Slider_Loaded"/>
private void Slider_Loaded(object sender, RoutedEventArgs e)
{
if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.Control", "FocusDisengaged"))
{
slider1.FocusDisengaged += Slider1_FocusDisengaged;
}
}