UIElement.GotFocus Evento

  • Referencia

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

RoutedEventHandler

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

Si usa la composición de controles o la composició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, puedes comprobar la propiedad UIElement.FocusState para determinar si era código de usuario o de 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.UI.Xaml.FocusState) 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 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 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