LosingFocusEventArgs.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 du focus est lancé.

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

winrt::guid CorrelationId();

public Guid CorrelationId { get; }

var guid = losingFocusEventArgs.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.

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v7.0)

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 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 (voir CoreWindow.Activated).

Voir aussi

• CorrelationId