FocusManagerGotFocusEventArgs.CorrelationId Proprietà

Definizione

Spazio dei nomi:

Microsoft.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 = focusManagerGotFocusEventArgs.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.

Commenti

È consigliabile usare gli eventi indirizzati dello stato attivo UIElement anziché gli eventi FocusManager ogni volta che è possibile.

Gli spostamenti dello stato attivo possono comportare numerose azioni dirette e indirette.

Ad esempio, esiste la sequenza standard di eventi che inizia con LostFocus e si sposta attraverso LostFocus, GettingFocus, in GotFocus. Questi eventi di messa a fuoco vengono in genere indirizzati attraverso più elementi nell'albero degli elementi (incluso FocusManager).

In alcuni casi, l'evento di messa a fuoco può anche essere riindirizzato. Ad esempio, se l'elemento di destinazione non è valido per qualche motivo, è possibile chiamare TrySetNewFocusedElement dall'evento LosingFocus per riassegnare lo stato attivo a un altro elemento.

In altri casi, potrebbe essere necessario annullare una modifica dello stato attivo da uno dei gestori eventi dello stato attivo.

Inoltre, poiché gli eventi dello 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 attivo, viene generato un elemento univoco CorrelationId per tenere traccia di un evento attivo in tutte queste azioni di messa a fuoco.

Quando viene generato un nuovo CorrelationId oggetto:

• L'utente sposta lo stato attivo.
• L'app sposta lo stato attivo usando metodi come UIElement.Focus o FocusManager.TryFocusAsync.
• L'app ottiene/perde lo stato attivo a causa dell'attivazione della finestra (vedere Window.Activated).

Vedi anche

• CorrelationId
• Interazioni tramite tastiera
• Spostamento attivo per tastiera, gamepad, controllo remoto e strumenti di accessibilità
• Spostamento dello stato attivo a livello di codice