Partager via

UIElement.GotFocus Événement

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

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

RoutedEventHandler

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 et la gestion GotFocus de l’interface utilisateur sur un conteneur tel qu’un Panel ou GridView, déterminez quel élément de la composition a reçu le focus en vérifiant l’OriginalSource sur les données d’événement.

Comme l’événement GotFocus n’a pas de données d’événement spécialisées, vous pouvez case activée la propriété UIElement.FocusState pour déterminer si c’est le code d’utilisateur ou d’application qui a provoqué l’augmentation du focus d’un élément.

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 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 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, 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énementGotFocus. 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