共用方式為


GettingFocusEventArgs.CorrelationId 屬性

定義

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

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 需求

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

備註

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

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

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

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

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

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

產生新的 CorrelationId 時:

適用於

另請參閱