FocusManagerLostFocusEventArgs.CorrelationId Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Input

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

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

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = focusManagerLostFocusEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Guid

Valeur de propriété

Guid

Platform::Guid

winrt::guid

ID unique, le cas échéant. Sinon, null.

La valeur par défaut est null.

Remarques

Nous vous recommandons d’utiliser les événements routés de focus UIElement au lieu des événements FocusManager chaque fois que cela est possible.

Les mouvements 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 à travers plusieurs éléments de l’arborescence des é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 cibler à nouveau 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 focus.

En outre, étant donné que les événements focus sont déclenchés de manière asynchrone, le focus peut changer à nouveau avant qu’un événement focus précédent ne soit terminé.

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

Un nouveau CorrelationId est généré dans les cas suivants :

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

Voir aussi

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