Partilhar via


Control.IsFocusEngaged Propriedade

Definição

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;
}

Aplica-se a