GettingFocusEventArgs.CorrelationId 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

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

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

Guid

Platform::Guid

winrt::guid

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

預設值為 null。

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

焦點移動可能會導致一些直接和間接動作。

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

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

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

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

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

產生新的 CorrelationId 時：