ScrollingScrollAnimationStartingEventArgs.CorrelationId Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft die Korrelations-ID ab, die der animierten Scrolloffsetänderung zugeordnet ist, die zuvor von ScrollTo oder ScrollByzurückgegeben wurde.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingScrollAnimationStartingEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Eigenschaftswert

Int32

int

Die Korrelations-ID, die der Änderung des animierten Scrolloffsets zugeordnet ist.

Hinweise

Jede programmgesteuerte Bildlauf- oder Zoomänderung ist einer bestimmten Korrelations-ID-Nummer zugeordnet. Diese Zahl wird angegeben, wenn eine Ansichtsänderung mit ScrollTo, ScrollBy, AddScrollVelocity, ZoomByZoomTooder AddZoomVelocity als Rückgabewert angefordert wird. Eine Korrelations-ID wird auch im BringingIntoView-Ereignis bereitgestellt, das am Anfang einer Bring-in-View-Anforderungsteilnahme ausgelöst wird. Dies markiert den Beginn der Lebensdauer einer Korrelations-ID.

Dieselbe Zahl wird dann in nachfolgenden Ereignissen wie ScrollAnimationStarting und ScrollCompleted oder ZoomAnimationStarting und ZoomCompleted verfügbar gemacht. Auf diese Weise können Sie Ereignisse mit ihrem auslösenden Methodenaufruf oder deren Anforderung abgleichen.

Die Lebensdauer einer Korrelations-ID endet immer mit einem Vervollständigungsereignis: ScrollCompleted oder ZoomCompleted.

Die Lebensdauer von Korrelations-IDs kann sich überlappen. Beispielsweise generieren zwei Back-to-Back-Aufrufe ZoomTo zwei Korrelations-IDs mit überlappenden Lebensdauern.

Wenn eine neue Ansichtsänderung angefordert wird, während eine alte noch in Bearbeitung ist, wird die alte ansicht abgebrochen. Dieser Abbruch löst ein ScrollCompleted - oder ZoomCompleted -Ereignis mit dem alten CorrelationIdaus.