Control.RemoveFocusEngagement Método

Definição

Namespace:

Windows.UI.Xaml.Controls

Libera o foco dos limites de controle para um controle que tem envolvimento de foco (para interação remota/painel de jogos).

public:
 virtual void RemoveFocusEngagement() = RemoveFocusEngagement;

void RemoveFocusEngagement();

public void RemoveFocusEngagement();

function removeFocusEngagement()

Public Sub RemoveFocusEngagement ()

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 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. Você pode chamar RemoveFocusEngagement para desativar programaticamente um controle.

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

Compatibilidade de versões

O método RemoveFocusEngagement 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 chame esse método sem primeiro executar um runtime marcar. Este exemplo mostra como usar a classe ApiInformation para marcar para a presença desse método antes de usá-lo.

if (ApiInformation.IsMethodPresent("Windows.UI.Xaml.Controls.Control", "RemoveFocusEngagement"))
{
    control1.RemoveFocusEngagement();
}