ScrollingZoomAnimationStartingEventArgs.CorrelationId 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

获取与动画缩放因子更改关联的关联 ID，之前由 ZoomTo 或 ZoomBy返回。

public:
 property int CorrelationId { int get(); };

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingZoomAnimationStartingEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

属性值

Int32

int

与动画缩放因子更改关联的关联 ID。

注解

每个编程滚动或缩放更改都与特定的相关 ID 号相关联。 请求使用 ScrollTo、、ScrollByZoomToAddScrollVelocity、 ZoomBy 或 AddZoomVelocity 作为返回值的视图更改时，会提供该数字。 在引入视图请求参与开始时引发的 BringingIntoView 事件中也提供了相关 ID。 这标志着相关 ID 生存期的开始。

然后，在后续事件（如 ScrollAnimationStarting 和 ScrollCompleted 或 ZoomAnimationStarting 和 ZoomCompleted）中公开相同的数字。 这使你可以将事件与其触发方法调用或请求进行匹配。

相关 ID 的生存期始终以完成事件结尾： ScrollCompleted 或 ZoomCompleted。

相关 ID 的生存期可以重叠。 例如，两个背靠背 ZoomTo 调用将生成两个具有重叠生存期的相关 ID。

在旧视图仍在进行中请求新视图更改时，会取消旧视图更改。 该取消使用ScrollCompleted旧 CorrelationId触发 或 ZoomCompleted 事件。