Lenguaje

UIElement.GotFocus Evento

Definición

Espacio de nombres:
Microsoft.UI.Xaml
Editar

Se produce cuando un UIElement recibe el foco. Este evento se genera de forma asincrónica, por lo que el foco puede volver a moverse antes de que se complete la propagación.

// Register
event_token GotFocus(RoutedEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::GotFocus_revoker GotFocus(auto_revoke_t, RoutedEventHandler const& handler) const;
public event RoutedEventHandler GotFocus;
function onGotFocus(eventArgs) { /* Your code */ }
uIElement.addEventListener("gotfocus", onGotFocus);
uIElement.removeEventListener("gotfocus", onGotFocus);
- or -
uIElement.ongotfocus = onGotFocus;
Public Custom Event GotFocus As RoutedEventHandler 
<uiElement GotFocus="eventhandler"/>

Tipo de evento

RoutedEventHandler

Comentarios

Se recomienda usar los eventos enrutados del foco UIElement en lugar de los eventos focusManager siempre que sea posible.

Solo un único elemento de interfaz de usuario a la vez puede tener el foco.

Un control puede obtener el foco cuando otro control pierde el foco, cambia la vista de la aplicación, cambia las aplicaciones del usuario o el usuario interactúa con el sistema de modo que la aplicación ya no esté en primer plano.

LostFocus se genera antes de GotFocus.

Si usa la composición de controles o la redacción de la interfaz de usuario y el control GotFocus en un contenedor como un Panel o GridView, determine qué elemento de la composición recibió el foco comprobando originalSource en los datos del evento.

Como el GotFocus evento no tiene datos de eventos especializados, puede comprobar la propiedad UIElement.FocusState para determinar si era código de usuario o aplicación que provocó que un elemento ganara el foco.

private void panel_GotFocus(object sender, RoutedEventArgs e)
{
    UIElement uie = e.OriginalSource as UIElement;
    FocusState fc = uie.FocusState;
}

El foco del teclado es especialmente relevante para el control de eventos de teclado, ya que solo el UIElement centrado actualmente en el teclado puede ser el origen de los eventos de tecla KeyUp y KeyDown . Las aplicaciones pueden llamar a UIElement.Focus(Microsoft. Interfaz de usuario. Xaml.FocusState) como una acción de inicialización para que los eventos clave de la aplicación como un todo se puedan usar para detectar las teclas de acceso o acelerador. Para obtener más información, consulta interacciones con el teclado.

GotFocus es un evento enrutado. Para obtener más información sobre el concepto de evento enrutado, consulta Información general sobre eventos y eventos enrutados.

Es posible que determinados controles de Windows Runtime tengan control basado en clases para el GotFocus evento. Si es así, el control probablemente tiene una invalidación para el método OnGotFocus. Normalmente, el evento está marcado como controlado por el controlador de clases y el evento GotFocus no se genera para controlarlo ningún controlador de código de usuario en ese control. Los controles pueden controlar el evento para cargar una propiedad de estado visual que muestre un rectángulo de foco.

El rectángulo de foco de un control es un componente visual importante que ayuda a la accesibilidad mediante la identificación del elemento centrado actual e indica dónde está el usuario dentro de la secuencia de tabulaciones de la interfaz de usuario de la aplicación. En algunos casos, focusState de la acción de enfoque es relevante para si se debe mostrar un indicador de foco visible.

Para obtener más información sobre cómo funciona el control basado en clases para eventos, consulta Información general sobre eventos y eventos enrutados. Para obtener más información sobre las secuencias de pestañas y la accesibilidad, consulta Accesibilidad del teclado.

Se aplica a

Consulte también