Control.IsFocusEngaged Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls

Obtém ou define um valor que indica se o foco está restrito dentro dos limites de controle (para interação remota/painel de jogos).

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

Valor da propriedade

Boolean

bool

true se o foco estiver 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

IsFocusEngagementEnabled deve ser true e o controle deve ter foco antes de definir a propriedade IsFocusEngaged como true. Caso contrário, ocorrerá uma exceção de runtime.

O envolvimento com foco facilita o uso de um painel de jogo ou controle remoto para interagir com um aplicativo. Definir o envolvimento 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 IsFocusEngaged 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 que a "versão introduzida" mostrada no bloco Requisitos posteriormente 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", "IsFocusEngaged"))
{
    slider1.IsFocusEngaged = true;
}