Control.FocusEngaged Evento

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls

Se produce cuando el foco está restringido dentro de los límites del control (para la interacción remota o el panel de juegos).

// 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

TypedEventHandler<Control,FocusEngagedEventArgs>

Requisitos de Windows

Familia de dispositivos	Windows 10 Anniversary Edition (se introdujo en la versión 10.0.14393.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v3.0)

Comentarios

Para obtener datos de eventos, consulte FocusEngagedEventArgs.

La interacción con el foco facilita el uso de un panel de juegos o un control remoto para interactuar con una aplicación. Establecer la interacción de foco no afecta al teclado ni a otros dispositivos de entrada.

Cuando la propiedad IsFocusEngagementEnabled se establece en true, marca el control como que requiere interacción con el foco. Esto significa que el usuario debe presionar el botón A/Seleccionar para "usar" el control e interactuar con él. Cuando terminen, pueden presionar el botón B/Atrás para desenganchar el control y alejarse de él.

Para obtener más información sobre esta propiedad, consulta la sección Participación de foco del artículo Diseño para Xbox y TV .

Compatibilidad de versiones

El evento FocusEngaged no está disponible antes de Windows 10, versión 1607. Si la configuración "versión mínima de la plataforma" de la aplicación en Microsoft Visual Studio es menor que la "versión introducida" que se muestra en el bloque Requisitos más adelante en esta página, debe diseñar y probar la aplicación para tener en cuenta esto. Para obtener más información, consulta Código adaptable de versión.

Para evitar excepciones cuando la aplicación se ejecute en versiones anteriores de Windows 10, no conecte este evento sin realizar primero una comprobación en tiempo de ejecución. En este ejemplo se muestra cómo usar la clase ApiInformation para comprobar la presencia de este evento antes de usarla.

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