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 du 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.
La valeur par défaut est Null.
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.
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).