ScrollingZoomCompletedEventArgs.CorrelationId Eigenschaft

Definition

Namespace:

Microsoft.UI.Xaml.Controls

Ruft die Korrelations-ID ab, die der Zoomfaktoränderung zugeordnet ist, die zuvor von ZoomTooder ZoomBy,AddZoomVelocityzurückgegeben wurde.

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

int CorrelationId();

public int CorrelationId { get; }

var int32 = scrollingZoomCompletedEventArgs.correlationId;

Public ReadOnly Property CorrelationId As Integer

Eigenschaftswert

Int32

int

Die Korrelations-ID, die der Zoomfaktoränderung 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, ZoomToAddScrollVelocity, ZoomBy oder AddZoomVelocity als Rückgabewert angefordert wird. Eine Korrelations-ID wird auch im BringingIntoView-Ereignis bereitgestellt, das am Anfang einer Teilnahme an einer Bring-in-View-Anforderung 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 deren auslösenden Methodenaufruf oder -anforderung abgleichen.

Die Lebensdauer einer Korrelations-ID endet immer mit einem Abschlussereignis: ScrollCompleted oder ZoomCompleted.

Die Lebensdauer von Korrelations-IDs kann sich überschneiden. 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 ausgeführt wird, wird die alte ansicht abgebrochen. Dieser Abbruch löst ein ScrollCompleted - oder ZoomCompleted -Ereignis mit dem alten CorrelationIdaus.