ScrollingScrollAnimationStartingEventArgs.CorrelationId Свойство

Определение

Пространство имен:

Microsoft.UI.Xaml.Controls

Возвращает идентификатор корреляции, связанный с изменением смещения анимированной прокрутки ScrollTo , ранее возвращенным или ScrollBy.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingScrollAnimationStartingEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Значение свойства

Int32

int

Идентификатор корреляции, связанный с изменением смещения анимированной прокрутки.

Комментарии

Каждое программное изменение прокрутки или масштабирования связано с определенным идентификатором корреляции. Это число указывается при запросе изменения представления с ScrollToпомощью , ScrollBy, AddScrollVelocity, ZoomToZoomBy или AddZoomVelocity в качестве возвращаемого значения. Идентификатор корреляции также предоставляется в событии BringingIntoView , которое возникает в начале участия в запросе на вывод в представление. Это знаменует собой начало времени существования идентификатора корреляции.

Это же число затем отображается в последующих событиях, таких как ScrollAnimationStarting и ScrollCompleted или ZoomAnimationStarting и ZoomCompleted. Это позволяет сопоставлять события с их вызовом или запросом метода активации.

Время существования идентификатора корреляции всегда заканчивается событием завершения: ScrollCompleted или ZoomCompleted.

Время существования идентификаторов корреляции может перекрываться. Например, два обратных вызова создают два идентификатора корреляции с перекрывающимися ZoomTo временем существования.

При запросе нового изменения представления в то время как старое еще выполняется, старое отменяется. Эта отмена активирует ScrollCompleted событие или ZoomCompleted со старым CorrelationId.