GettingFocusEventArgs.CorrelationId Proprietà

Definizione

Spazio dei nomi:

Windows.UI.Xaml.Input

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:

• 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).

Vedi anche

• CorrelationId
• Interazioni tramite tastiera
• Spostamento dello stato attivo per tastiera, game pad, telecomando e strumenti di accessibilità
• Spostamento dello stato attivo a livello di codice