Control.IsFocusEngagementEnabled Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Controls

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

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

bool IsFocusEngagementEnabled();

void IsFocusEngagementEnabled(bool value);

public bool IsFocusEngagementEnabled { get; set; }

var boolean = control.isFocusEngagementEnabled;
control.isFocusEngagementEnabled = boolean;

Public Property IsFocusEngagementEnabled As Boolean

<control IsFocusEngagementEnabled="bool"/>

Значение свойства

Boolean

bool

Значение true , если фокус можно ограничить в пределах элемента управления; в противном случае — false.

Требования к Windows

Семейство устройств	Windows 10 Anniversary Edition (появилось в 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v3.0)

Комментарии

Фокусировка упрощает использование игровой площадки или пульта дистанционного управления для взаимодействия с приложением. Настройка задействования фокуса не влияет на клавиатуру или другие устройства ввода.

Если свойству IsFocusEngagementEnabled присвоено значение true, элемент управления помечается как требующий задействования фокуса. Это означает, что пользователь должен нажать кнопку A/выбор, чтобы включить элемент управления и начать с ним взаимодействовать. По завершении они могут нажать кнопку B/Back, чтобы отключить элемент управления и уйти от него.

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

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

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

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

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