Control.RemoveFocusEngagement Método
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 ()| Família de dispositivos |
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v3.0)
|
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 .
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();
}
| Produto | Versões |
|---|---|
| WinRT | Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |