Freigeben über


GettingFocusEventArgs.CorrelationId Eigenschaft

Definition

Ruft die eindeutige ID ab, die generiert wird, wenn ein Fokusverschiebungsereignis initiiert wird.

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

Eigenschaftswert

Guid

Platform::Guid

winrt::guid

Die eindeutige ID, falls vorhanden. Andernfalls null.

Der Standardwert ist NULL.

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Hinweise

Fokusverschiebungen können zu einer Reihe von direkten und indirekten Aktionen führen.

Beispielsweise gibt es die Standardsequenz von Ereignissen, die mit LosingFocus beginnt und sich über LostFocus, GettingFocus, zu GotFocus bewegt. Diese Fokusereignisse werden in der Regel über mehrere Elemente in der Elementstruktur (einschließlich FocusManager) weitergeleitet.

In einigen Fällen kann das Fokusereignis auch umgeleitet werden. Wenn das Zielelement beispielsweise aus irgendeinem Grund ungültig ist, können Sie TrySetNewFocusedElement aus dem LosingFocus-Ereignis aufrufen, um den Fokus erneut auf ein anderes Element auszurichten.

In anderen Fällen müssen Sie möglicherweise eine Fokusänderung von einem Ihrer Fokusereignishandler abbrechen.

Da Fokusereignisse asynchron ausgelöst werden, ändert sich der Fokus möglicherweise erneut, bevor ein vorheriges Fokusereignis ausgeführt wurde.

Jedes Mal, wenn ein Fokusereignis initiiert wird, wird eine eindeutige CorrelationId generiert, mit der Sie ein Fokusereignis in diesen Fokusaktionen nachverfolgen können.

Eine neue CorrelationId wird in folgenden Fällen generiert:

Gilt für:

Weitere Informationen