ScrollingZoomAnimationStartingEventArgs.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 änderung des animierten Zoomfaktors zugeordnet ist, die zuvor von ZoomTo oder ZoomByzurückgegeben wurde.
public:
property int CorrelationId { int get(); };int CorrelationId();public int CorrelationId { get; }var int32 = scrollingZoomAnimationStartingEventArgs.correlationId;Public ReadOnly Property CorrelationId As IntegerEigenschaftswert
int
Die Korrelations-ID, die der Änderung des animierten Zoomfaktors 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.