LosingFocusEventArgs.CorrelationId 屬性

定義

命名空間:

Windows.UI.Xaml.Input

取得起始焦點移動事件時所產生的唯一識別碼。

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

屬性值

Guid

Platform::Guid

winrt::guid

如果有的話，則為唯一識別碼。 否則為 null。

預設值為 null。

Windows 需求

裝置系列	Windows 10, version 1809 (已於 10.0.17763.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v7.0 引進)

備註

焦點移動可能會導致許多直接和間接動作。

例如，有一連串以LosingFocus開頭的事件，並透過LostFocus、GettingFocus 移至 GotFocus。 這些焦點事件通常會透過元素樹狀結構中的多個元素路由傳送， (包括 FocusManager) 。

在某些情況下，焦點事件也可以重新路由傳送。 例如，如果目標元素因某些原因無效，您可能會從LosingFocus 事件呼叫 TrySetNewFocusedElement，將焦點重新設為另一個專案。

在其他情況下，您可能需要取消其中一個焦點事件處理常式的焦點變更。

此外，因為焦點事件會以非同步方式引發，所以在先前的焦點事件完成執行之前，焦點可能會再次變更。

每次起始焦點事件時，都會產生唯一的 CorrelationId，以協助您追蹤這些焦點動作中的焦點事件。

當：

• 使用者移動焦點。
• 應用程式會使用 Control.Focus 或 FocusManager.TryFocusAsync等方法移動焦點。
• 應用程式因為視窗啟用而失去焦點， (請參閱 CoreWindow.Activated) 。

另請參閱

• CorrelationId