ScrollingScrollCompletedEventArgs.CorrelationId Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene l'ID di correlazione associato alla modifica degli offset, restituita in precedenza da ScrollTo
, ScrollBy
o AddScrollVelocity
.
public:
property int CorrelationId { int get(); };
int CorrelationId();
public int CorrelationId { get; }
var int32 = scrollingScrollCompletedEventArgs.correlationId;
Public ReadOnly Property CorrelationId As Integer
Valore della proprietà
int
ID di correlazione associato alla modifica degli offset.
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
, , AddScrollVelocity
ScrollBy
, ZoomBy
ZoomTo
o 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 ScrollTo
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
.