GettingFocusEventArgs.CorrelationId 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

编辑

获取启动焦点移动事件时生成的唯一 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 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

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

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

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

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

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

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

在出现时，会生成新的 CorrelationId：