Condividi tramite


GettingFocusEventArgs.CorrelationId Proprietà

Definizione

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à

Guid

Platform::Guid

winrt::guid

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:

Si applica a

Vedi anche