ScrollingScrollCompletedEventArgs.CorrelationId 속성

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

이전에 , ScrollBy또는 AddScrollVelocity에서 반환ScrollTo한 오프셋 변경과 관련된 상관 관계 ID를 가져옵니다.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingScrollCompletedEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

속성 값

Int32

int

오프셋과 연결된 상관 관계 ID가 변경됩니다.

설명

각 프로그래밍 방식 스크롤 또는 확대/축소 변경은 특정 상관 관계 ID 번호와 연결됩니다. 이 숫자는 , , ScrollBy, AddZoomVelocityZoomByZoomToAddScrollVelocity또는 를 반환 값으로 ScrollTo사용하여 뷰 변경을 요청할 때 제공됩니다. 상관 관계 ID는 가져오기-인-뷰 요청 참여의 시작 부분에서 발생한 BringIntoView 이벤트에서도 제공됩니다. 이는 상관 관계 ID의 수명 시작 부분을 표시합니다.

그런 다음 ScrollAnimationStarting 및 ScrollCompleted 또는 ZoomAnimationStarting 및 ZoomCompleted와 같은 후속 이벤트에서 동일한 숫자가 노출됩니다. 이렇게 하면 이벤트를 트리거하는 메서드 호출 또는 요청과 일치시킬 수 있습니다.

상관 관계 ID의 수명은 항상 완료 이벤트 인 ScrollCompleted 또는 ZoomCompleted로 끝납니다.

상관 관계 ID의 수명은 겹칠 수 있습니다. 예를 들어 두 개의 백 투 백 ScrollTo 호출은 수명이 겹치는 두 개의 상관 관계 ID를 생성합니다.

이전 보기가 아직 진행 중인 동안 새 보기 변경이 요청되면 이전 보기가 취소됩니다. 이 취소는 이전 CorrelationId를 사용하여 ScrollCompleted 또는 ZoomCompleted 이벤트를 트리거합니다.