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
屬性值
如果有的話,唯一識別碼;否則為 null
。 預設值為 null
。
備註
焦點移動可能會導致一些直接和間接動作。
例如,有以LosingFocus開頭的標準事件序列,並透過LostFocus、GettingFocus 移至GotFocus。 這些焦點事件通常會透過專案樹狀結構中的多個元素路由傳送, (包括 FocusManager) 。
在某些情況下,焦點事件也可以重新路由傳送。 例如,如果目標元素因某些原因無效,您可能會從LosingFocus 事件呼叫 TrySetNewFocusedElement,將焦點重新設為另一個專案。
在其他情況下,您可能需要取消其中一個焦點事件處理常式的焦點變更。
此外,因為焦點事件會以非同步方式引發,因此在先前的焦點事件完成執行之前,焦點可能會再次變更。
每次起始焦點事件時,都會產生唯 CorrelationId
一的 ,以協助您在整個焦點動作中追蹤焦點事件。
CorrelationId
當:
- 使用者移動焦點。
- 應用程式會使用 UIElement.Focus 或 FocusManager.TryFocusAsync等方法移動焦點。
- 應用程式因為視窗啟用而失去焦點, (請參閱 Window.Activated) 。