LosingFocusEventArgs.CorrelationId 属性

定义

命名空间:

Windows.UI.Xaml.Input

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

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

属性值

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 开头，并通过 LostFocus、 GettingFocus 移动到 GotFocus。 这些焦点事件通常通过元素树中的多个元素进行路由， (包括 FocusManager) 。

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

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

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

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

在出现错误时，将生成新的 CorrelationId：

• 用户移动焦点。
• 应用使用 Control.Focus 或 FocusManager.TryFocusAsync 等方法移动焦点。
• 应用因窗口激活而获得/失去焦点 (请参阅 CoreWindow.Activated) 。

另请参阅

• CorrelationId