ScrollingZoomCompletedEventArgs.CorrelationId Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 IntegerEigenschaftswert
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.