BeginStoryboard.HandoffBehavior 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 das richtige Übergabeverhalten zum Starten einer Animationsuhr in diesem Storyboard ab oder legt es fest.
public:
property System::Windows::Media::Animation::HandoffBehavior HandoffBehavior { System::Windows::Media::Animation::HandoffBehavior get(); void set(System::Windows::Media::Animation::HandoffBehavior value); };public System.Windows.Media.Animation.HandoffBehavior HandoffBehavior { get; set; }member this.HandoffBehavior : System.Windows.Media.Animation.HandoffBehavior with get, setPublic Property HandoffBehavior As HandoffBehaviorEigenschaftswert
Einer der HandoffBehavior-Enumerationswerte. Der Standardwert ist SnapshotAndReplace.
Hinweise
Verwenden von Compose HandoffBehavior
Wenn Sie eine Storyboard- , AnimationTimeline- oder AnimationClock -Eigenschaft mithilfe HandoffBehavior.Composevon anwenden, nutzen alle Clock Objekte, die zuvor dieser Eigenschaft zugeordnet sind, weiterhin Systemressourcen. Das Zeitsteuerungssystem entfernt diese Uhren nicht automatisch.
Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe von Compose anwenden, sollten Sie zusammengesetzte Uhren, nachdem sie ausgeführt wurden, aus der animierten Eigenschaft entfernen. Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen:
Um alle Uhren aus einer Eigenschaft zu entfernen, verwenden Sie die ApplyAnimationClock(DependencyProperty, AnimationClock)- oder BeginAnimation(DependencyProperty, AnimationTimeline)-Methode des animierten Objekts. Geben Sie die zu animierende Eigenschaft als ersten Parameter und
nullals zweiten an. Dies entfernt alle Animationsuhren aus der Eigenschaft.Um eine bestimmte AnimationClock-Liste von Uhren zu entfernen, verwenden Sie die Eigenschaft Controller von AnimationClock um eine ClockController abzurufen, und rufen Sie dann die Remove-Methode der ClockController auf. Dies geschieht in der Regel im Completed-Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren von ClockControllergesteuert werden können. Die Controller -Eigenschaft einer untergeordneten Uhr gibt zurück
null. Beachten Sie auch, dass das Completed Ereignis nicht aufgerufen wird, wenn die effektive Dauer der Uhr für immer ist. In diesem Fall muss der Benutzer bestimmen, wann aufgerufen Removewerden soll.
Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben. Wenn ein Objekt mit Garbage Collection erfasst wird, werden auch seine Uhren getrennt und Garbage Collection gesammelt.
Weitere Informationen zu Uhr-Objekten finden Sie unter Übersicht über das Animations- und Zeitsteuerungssystem.
