FocusManagerGotFocusEventArgs.CorrelationId Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 = focusManagerGotFocusEventArgs.correlationId;Public ReadOnly Property CorrelationId As GuidValeur de propriété
ID unique, le cas échéant ; sinon, null. Par défaut, il s’agit de 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 unique CorrelationId 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é lorsque :
- 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).