GettingFocusEventArgs.CorrelationId Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Input

Obtient l’ID unique généré lorsqu’un événement de mouvement du focus est lancé.

public:
 property Platform::Guid CorrelationId { Platform::Guid get(); };

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = gettingFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

Valeur de propriété

Guid

Platform::Guid

winrt::guid

L’ID unique, le cas échéant ; sinon, null. Par défaut, il s’agit de null.

Remarques

Les déplacements de focus peuvent entraîner un certain nombre d’actions directes et indirectes.

Par exemple, il existe la séquence standard d’événements qui commence par LosingFocus et passe par LostFocus, GettingFocus, à GotFocus. Ces événements de focus sont généralement routés via plusieurs éléments dans l’arborescence d’éléments (y compris le FocusManager).

Dans certains cas, l’événement focus peut également être routé à nouveau. Par exemple, si l’élément cible n’est pas valide pour une raison quelconque, vous pouvez appeler TrySetNewFocusedElement à partir de l’événement LosingFocus pour re-cibler le focus sur un autre élément.

Dans d’autres cas, vous devrez peut-être annuler un changement de focus à partir de l’un de vos gestionnaires d’événements de focus.

En outre, étant donné que les événements de focus sont déclenchés de manière asynchrone, le focus peut changer à nouveau avant la fin de l’exécution d’un événement focus précédent.

Chaque fois qu’un événement de focus est lancé, un événement unique CorrelationId est généré pour vous aider à suivre un événement focus tout au long de ces actions de focus.

Une nouvelle CorrelationId est générée dans les cas suivants :

• L’utilisateur déplace le focus.
• L’application déplace le focus à l’aide de méthodes telles que UIElement.Focus ou FocusManager.TryFocusAsync.
• L’application obtient/perd le focus en raison de l’activation de la fenêtre (voir Window.Activated).

Voir aussi

• CorrelationId
• Interactions avec le clavier
• Focus navigation pour le clavier, le boîtier de commande, le contrôle à distance et les outils d’accessibilité
• Navigation en mode focus programmé