Partage via


UIElement.GotFocus Événement

Définition

Se produit lorsqu’un élément UIElement reçoit le focus. Cet événement est déclenché de manière asynchrone, de sorte que le focus peut se déplacer à nouveau avant la fin de la bulle.

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

Type d'événement

Remarques

Nous vous recommandons d’utiliser les événements routés du focus UIElement au lieu des événements FocusManager dans la mesure du possible.

Un seul élément d’interface utilisateur à la fois peut avoir le focus.

Un contrôle peut obtenir le focus lorsqu’un autre contrôle perd le focus, que l’affichage de l’application change, que l’utilisateur change d’application ou que l’utilisateur interagit avec le système de sorte que l’application ne soit plus au premier plan.

LostFocus est déclenché avant GotFocus.

Si vous utilisez la composition de contrôles ou la composition de l’interface utilisateur et la gestion de GotFocus sur un conteneur tel qu’un Panel ou GridView, vous pouvez case activée OriginalSource sur les données d’événement pour déterminer quel élément de la composition a réellement reçu le focus.

GotFocus n’a pas de données d’événement spécialisées. Lorsque vous gérez GotFocus, vous souhaiterez peut-être déterminer si c’est le code de l’utilisateur ou de l’application qui a provoqué l’augmentation du focus d’un élément. Pour le déterminer dans votre gestionnaire, convertissez l’expéditeur de l’événement en objet Control et case activée l’état FocusState.

Le focus clavier est particulièrement pertinent pour la gestion des événements clavier, car seul l’élément UIElement actuellement axé sur le clavier peut être la source des événements de touches KeyUp et KeyDown . Les applications peuvent appeler Focus en tant qu’action d’initialisation afin que les événements clés de l’application dans son ensemble puissent être utilisés pour détecter les touches d’accès ou d’accélérateur. Pour plus d’informations, voir Interactions avec le clavier.

GotFocus est un événement routé. Pour plus d’informations sur le concept d’événement routé, consultez Vue d’ensemble des événements et des événements routés.

Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur des classes pour l’événement GotFocus. Dans ce cas, le contrôle a probablement un remplacement pour la méthode OnGotFocus. En règle générale, l’événement est marqué comme géré par le gestionnaire de classe, et l’événement GotFocus n’est pas déclenché pour être géré par les gestionnaires de code utilisateur sur ce contrôle. Les contrôles peuvent gérer l’événement afin de charger une propriété d’état visuel qui affiche un rectangle de focus.

Le rectangle de focus d’un contrôle est un composant visuel important qui facilite l’accessibilité en identifiant l’élément focus actuel et en indiquant où l’utilisateur se trouve dans la séquence d’onglets de l’interface utilisateur de l’application. Dans certains cas, l’état Focus de l’action focus est pertinent pour déterminer si un indicateur de focus visible doit s’afficher.

Pour plus d’informations sur le fonctionnement de la gestion basée sur les classes des événements, consultez Vue d’ensemble des événements et des événements routés. Pour plus d’informations sur les séquences d’onglets et l’accessibilité, consultez Accessibilité du clavier.

S’applique à

Voir aussi