ScrollingScrollAnimationStartingEventArgs.CorrelationId Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml.Controls

Ottiene l'ID di correlazione associato alla modifica dell'offset di scorrimento animato, restituita in precedenza da ScrollTo o ScrollBy.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingScrollAnimationStartingEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Valore della proprietà

Int32

int

ID correlazione associato alla modifica dell'offset di scorrimento animato.

Commenti

Ogni modifica dello scorrimento o dello zoom a livello di codice è associata a un determinato numero ID di correlazione. Questo numero viene fornito quando si richiede una modifica di visualizzazione con ScrollTo, , AddScrollVelocityScrollBy, ZoomByZoomToo AddZoomVelocity come valore restituito. Un ID di correlazione viene fornito anche nell'evento BringIntoView generato all'inizio di una partecipazione alla richiesta di visualizzazione di tipo bring-into. Questo contrassegna l'inizio della durata di un ID di correlazione.

Lo stesso numero viene quindi esposto negli eventi successivi, ad esempio ScrollAnimationStarting e ScrollCompleted o ZoomAnimationStarting e ZoomCompleted. In questo modo è possibile associare gli eventi alla chiamata o alla richiesta del metodo di attivazione.

La durata di un ID di correlazione termina sempre in un evento di completamento: ScrollCompleted o ZoomCompleted.

Le durata degli ID di correlazione possono sovrapporsi. Ad esempio, due chiamate back-to-back ZoomTo genereranno due ID di correlazione con durata sovrapposta.

Quando viene richiesta una nuova modifica della visualizzazione mentre una vecchia è ancora in corso, quella precedente viene annullata. L'annullamento attiva un ScrollCompleted evento o ZoomCompleted con il precedente CorrelationId.