GettingFocusEventArgs.CorrelationId Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene l'ID univoco generato quando viene avviato un evento di spostamento dello stato attivo.
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
Valore della proprietà
ID univoco, se presente. In caso contrario, null.
Il valore predefinito è Null.
Requisiti Windows
Famiglia di dispositivi |
Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)
|
Commenti
Gli spostamenti dello stato attivo possono comportare una serie di azioni dirette e indirette.
Ad esempio, esiste la sequenza standard di eventi che inizia con LosingFocus e si sposta attraverso LostFocus, GettingFocus, in GotFocus. Questi eventi di stato attivo vengono in genere indirizzati attraverso più elementi nell'albero degli elementi (incluso FocusManager).
In alcuni casi, l'evento di stato attivo può anche essere riindirizzato. Ad esempio, se l'elemento di destinazione non è valido per qualche motivo, è possibile chiamare TrySetNewFocusedElement dall'evento LosingFocus per assegnare nuovamente lo stato attivo a un altro elemento.
In altri casi, potrebbe essere necessario annullare una modifica dello stato attivo da uno dei gestori eventi di stato attivo.
Inoltre, poiché gli eventi di stato attivo vengono generati in modo asincrono, lo stato attivo potrebbe cambiare nuovamente prima che un evento di stato attivo precedente abbia terminato l'esecuzione.
Ogni volta che viene avviato un evento di stato attivo, viene generato un CorrelationId univoco che consente di tenere traccia di un evento di stato attivo in tutte queste azioni di stato attivo.
Viene generato un nuovo CorrelationId quando:
- L'utente sposta lo stato attivo.
- L'app sposta lo stato attivo usando metodi come Control.Focus o FocusManager.TryFocusAsync.
- L'app ottiene o perde lo stato attivo a causa dell'attivazione della finestra (vedere CoreWindow.Activated).