Control.IsFocusEngaged Свойство

Определение

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

Windows.UI.Xaml.Controls

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

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

bool IsFocusEngaged();

void IsFocusEngaged(bool value);

public bool IsFocusEngaged { get; set; }

var boolean = control.isFocusEngaged;
control.isFocusEngaged = boolean;

Public Property IsFocusEngaged As Boolean

<control IsFocusEngaged="bool"/>

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

Boolean

bool

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

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

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

Комментарии

IsFocusEngagementEnabled должно иметь значение true , а элемент управления должен иметь фокус, прежде чем присвоить свойству IsFocusEngaged значение true. В противном случае возникнет исключение среды выполнения.

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

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

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

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

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

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

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