GettingFocusEventArgs.CorrelationId 属性

定义

获取启动焦点移动事件时生成的唯一 ID。

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

唯一 ID(如果有)。 否则为 null

默认值为 null

Windows 要求

设备系列
Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

注解

焦点移动可能会导致许多直接和间接操作。

例如,事件的标准序列从 LosingFocus 开始,然后通过 LostFocusGettingFocus 移动到 GotFocus。 这些焦点事件通常通过元素树中的多个元素进行路由, (包括 FocusManager) 。

在某些情况下,焦点事件也可以重新路由。 例如,如果目标元素由于某种原因无效,则可以从 LosingFocus 事件调用 TrySetNewFocusedElement,以将焦点重新定位到另一个元素。

在其他情况下,可能需要取消某个焦点事件处理程序的焦点更改。

此外,由于焦点事件是异步引发的,因此焦点可能会在上一个焦点事件完成执行之前再次更改。

每次启动焦点事件时,都会生成一个唯一的 CorrelationId,以帮助在整个焦点操作中跟踪焦点事件。

在出现时,会生成新的 CorrelationId:

适用于

另请参阅