Langage

UIElement.GotFocus Événement

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Se produit lorsqu’un UIElement reçoit le focus. Cet événement est déclenché de façon asynchrone, ce qui permet au focus de se déplacer à nouveau avant la fin de l’opération.

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

RoutedEventHandler

Remarques

Nous vous recommandons d’utiliser les événements routés par le focus UIElement au lieu d’é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 se concentrer lorsqu’un autre contrôle perd le focus, que l’affichage de l’application change, que l’utilisateur change d’applications 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ôle ou la composition et la gestion GotFocus de l’interface utilisateur sur un conteneur tel qu’un Panneau ou GridView, déterminez l’élément de la composition qui a reçu le focus en vérifiant OriginalSource sur les données d’événement.

Comme l’événement GotFocus n’a pas de données d’événements spécialisées, vous pouvez vérifier la propriété UIElement.FocusState pour déterminer s’il s’agissait d’un code utilisateur ou d’application qui a provoqué un élément pour obtenir le focus.

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

Le focus clavier est particulièrement pertinent pour la gestion des événements de clavier, car seul l’uiElement centré sur le clavier peut être la source des événements de touche KeyUp et KeyDown . Les applications peuvent appeler UIElement.Focus(Microsoft. UI. Xaml.FocusState) 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, consultez interactions avec le clavier.

GotFocus est un événement routé. Pour plus d’informations sur le concept d’événement routé, consultez la vue d’ensemble des événements routés 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énementGotFocus. Si c’est le cas, le contrôle a probablement un remplacement pour la méthode OnGotFocus. En règle générale, l’événement est marqué géré par le gestionnaire de classes et l’événement GotFocus n’est pas déclenché pour la gestion 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 prioritaire 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 FocusState de l’action de 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 des classes pour les événements, consultez La vue d’ensemble des événements routés et des événements routés. Pour plus d’informations sur les séquences d’onglets et l’accessibilité, consultez l’accessibilité du clavier.

S’applique à

Voir aussi