Partilhar via


Control.FocusEngaged Evento

Definição

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

// Register
event_token FocusEngaged(TypedEventHandler<Control, FocusEngagedEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
Control::FocusEngaged_revoker FocusEngaged(auto_revoke_t, TypedEventHandler<Control, FocusEngagedEventArgs const&> const& handler) const;
public event TypedEventHandler<Control,FocusEngagedEventArgs> FocusEngaged;
function onFocusEngaged(eventArgs) { /* Your code */ }
control.addEventListener("focusengaged", onFocusEngaged);
control.removeEventListener("focusengaged", onFocusEngaged);
- or -
control.onfocusengaged = onFocusEngaged;
Public Custom Event FocusEngaged As TypedEventHandler(Of Control, FocusEngagedEventArgs) 
<control FocusEngaged="eventhandler"/>

Tipo de evento

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 FocusEngagedEventArgs.

O envolvimento em foco facilita o uso de um controle remoto ou de teclado de jogo para interagir com um aplicativo. Definir a participação 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

O evento FocusEngaged 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 do que a "versão introduzida" mostrada no bloco Requisitos mais adiante 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", "FocusEngaged"))
    {
        slider1.FocusEngaged += Slider1_FocusEngaged;
    }
}

Aplica-se a