LosingFocusEventArgs.CorrelationId 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得起始焦點移動事件時所產生的唯一識別碼。
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
屬性值
如果有的話,則為唯一識別碼。 否則為 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) 。