Control.IsFocusEngagementEnabled Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtenha ou define um valor que indica se o foco pode ser restrito dentro dos limites de controle (para interação remota/painel de jogos).

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"/>

Valor da propriedade

Boolean

bool

true se o foco puder ser restrito dentro dos limites de controle; caso contrário, false.

Requisitos do Windows

Família de dispositivos	Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v3.0)

Comentários

O envolvimento em foco facilita o uso de um controle remoto ou de teclado de jogo para interagir com um aplicativo. Definir a participação de foco não afeta o teclado ou outros dispositivos de entrada.

Quando a propriedade IsFocusEngagementEnabled é definida como true, ela marca o controle como exigindo envolvimento de foco. Isso significa que o usuário deve pressionar o botão A/Selecionar para "envolver" o controle e interagir com ele. Quando terminarem, eles poderão pressionar o botão B/Voltar para desativar o controle e navegar para longe dele.

Para obter mais informações sobre essa propriedade, consulte a seção Envolvimento em foco do artigo Projetando para Xbox e TV .

Compatibilidade de versões

A propriedade IsFocusEngagementEnabled não está disponível antes do Windows 10, versão 1607. Se a configuração de "versão mínima da plataforma" do seu aplicativo no Microsoft Visual Studio for menor do que a "versão introduzida" mostrada no bloco Requisitos mais adiante nesta página, você deverá projetar e testar seu aplicativo para considerar isso. Para obter mais informações, consulte Código adaptável de versão.

Para evitar exceções quando seu aplicativo é executado em versões anteriores do Windows 10, não defina essa propriedade em XAML nem use-a sem executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença dessa propriedade antes de defini-la.

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