LosingFocusEventArgs.CorrelationId Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 = losingFocusEventArgs.correlationId;
Public ReadOnly Property CorrelationId As Guid
Eigenschaftswert
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 über LostFocus, GettingFocus, zu GotFocus wechselt. Diese Fokusereignisse werden in der Regel durch 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 auf ein anderes Element zu richten.
In anderen Fällen müssen Sie möglicherweise eine Fokusänderung von einem Ihrer Fokusereignishandler abbrechen.
Da Fokusereignisse asynchron ausgelöst werden, kann sich der Fokus darüber hinaus erneut ändern, bevor die Ausführung eines vorherigen Fokusereignisses abgeschlossen wurde.
Jedes Mal, wenn ein Fokusereignis initiiert wird, wird eine eindeutige CorrelationId generiert, damit Sie ein Fokusereignis während dieser Fokusaktionen nachverfolgen können.
Eine neue CorrelationId wird in folgenden Fällen generiert:
- Der Benutzer verschiebt den Fokus.
- Die App verschiebt den Fokus mithilfe von Methoden wie Control.Focus oder FocusManager.TryFocusAsync.
- Die App erhält/verliert den Fokus aufgrund der Fensteraktivierung (siehe CoreWindow.Activated).