ScrollingZoomCompletedEventArgs.CorrelationId Свойство

Определение

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

Microsoft.UI.Xaml.Controls

Возвращает идентификатор корреляции, связанный с изменением коэффициента масштабирования, ранее возвращенный ZoomTo, ZoomBy, или AddZoomVelocity.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingZoomCompletedEventArgs.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.