UIElement.GotFocus Evento

Definición

Se produce cuando un UIElement recibe el foco. Este evento se genera de forma asincrónica, por lo que el foco puede moverse de nuevo antes de que se complete el propagamiento.

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

Comentarios

Se recomienda usar los eventos enrutados de 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 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 composición de la interfaz de usuario y controla GotFocus en un contenedor como un Panel o GridView, es posible que desee comprobar originalSource en los datos del evento para determinar qué elemento de la composición recibió realmente el foco.

GotFocus no tiene datos de eventos especializados. Dónde controlas GotFocus, es posible que quieras determinar si era el código de usuario o de la aplicación que provocaba que un elemento ganara el foco. Para determinar esto en el controlador, convierta el remitente del evento en un objeto Control y compruebe 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 Focus como una acción de inicialización para que los eventos clave de la aplicación en su conjunto se puedan usar para detectar el acceso o las teclas de aceleración. Para obtener más información, consulta Interacciones de teclado.

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

Los controles de Windows Runtime específicos pueden tener control basado en clases para el evento GotFocus. 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 clase 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 se encuentra el usuario dentro de la secuencia de tabulación de la interfaz de usuario de la aplicación. En algunos casos, el FocusState de la acción de enfoque es relevante para si se debe mostrar un indicador de enfoque 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