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 des Handoff-HandoffBehavior

Wenn Sie eine , oder AnimationTimelineAnimationClock eine StoryboardEigenschaft verwendenHandoffBehavior.Compose, verwenden Sie alle Clock zuvor mit dieser Eigenschaft verknüpften Objekte weiterhin Systemressourcen; das Zeitgebersystem entfernt diese Uhren nicht automatisch.

Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren anwenden, die verwendet Composewerden, sollten Sie nach Abschluss der animierten Eigenschaft komponieren. Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen:

• Um alle Uhren aus einer Eigenschaft zu entfernen, verwenden Sie die oder BeginAnimation(DependencyProperty, AnimationTimeline) methode ApplyAnimationClock(DependencyProperty, AnimationClock) des animierten Objekts. Geben Sie die Eigenschaft an, die als erster Parameter animiert wird, und null als zweite. Dies entfernt alle Animationsuhren aus der Eigenschaft.

• Um eine bestimmte AnimationClock Liste von Uhren zu entfernen, verwenden Sie die Eigenschaft AnimationClock des Abrufens eines ClockController, und rufen Sie dann die Controller Remove Methode der ClockController. Dies erfolgt in der Completed Regel im Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren durch eine ClockController; die Controller Eigenschaft einer untergeordneten Uhr gesteuert nullwerden können. Beachten Sie auch, dass das Completed Ereignis nicht aufgerufen wird, wenn die effektive Dauer der Uhr immer ist. In diesem Fall muss der Benutzer bestimmen, wann aufgerufen werden Removesoll.

Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben. Wenn ein Objekt gesammelt wird, werden seine Uhr auch getrennt und müll gesammelt.

Weitere Informationen zu Uhrobjekten finden Sie unter Übersicht über Animation und Timing System.