Control.FocusDisengaged Evento

Definição

Namespace:

Windows.UI.Xaml.Controls

Ocorre quando o foco é liberado dos limites de controle (para interação remota/painel de jogos).

// Register
event_token FocusDisengaged(TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

// Revoke with event_token
void FocusDisengaged(event_token const* cookie) const;

// Revoke with event_revoker
Control::FocusDisengaged_revoker FocusDisengaged(auto_revoke_t, TypedEventHandler<Control, FocusDisengagedEventArgs const&> const& handler) const;

public event TypedEventHandler<Control,FocusDisengagedEventArgs> FocusDisengaged;

function onFocusDisengaged(eventArgs) { /* Your code */ }
control.addEventListener("focusdisengaged", onFocusDisengaged);
control.removeEventListener("focusdisengaged", onFocusDisengaged);
- or -
control.onfocusdisengaged = onFocusDisengaged;

Public Custom Event FocusDisengaged As TypedEventHandler(Of Control, FocusDisengagedEventArgs) 

<control FocusDisengaged="eventhandler"/>

Tipo de evento

TypedEventHandler<Control,FocusDisengagedEventArgs>

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

Para obter dados de evento, consulte FocusDisengagedEventArgs.

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, consulte a seção Envolvimento em foco do artigo Projetando para Xbox e TV .

Compatibilidade de versões

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

<Slider x:Name="slider1" Loaded="Slider_Loaded"/>

private void Slider_Loaded(object sender, RoutedEventArgs e)
{
    if (ApiInformation.IsEventPresent("Windows.UI.Xaml.Controls.Control", "FocusDisengaged"))
    {
        slider1.FocusDisengaged += Slider1_FocusDisengaged;
    }
}