BeginStoryboard.HandoffBehavior Eigenschaft

Definition

Namespace:

System.Windows.Media.Animation

Assembly:

PresentationFramework.dll

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, set

Public Property HandoffBehavior As HandoffBehavior

Eigenschaftswert

HandoffBehavior

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 null als 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.