BeginStoryboard.HandoffBehavior Eigenschaft

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

Einer der HandoffBehavior Enumerationswerte. Der Standardwert ist SnapshotAndReplace.

Hinweise

Verwenden des VerfassenhandoffBehavior

Wenn Sie ein , oder eine Eigenschaft mithilfe einer HandoffBehavior.ComposeEigenschaft anwenden, werden alle Clock objekte, die dieser Eigenschaft zuvor zugeordnet waren, weiterhin Systemressourcen verbrauchen. Das Timing-System entfernt diese Uhren nicht automatisch.AnimationClockAnimationTimelineStoryboard

Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren verwenden Compose, sollten Sie das Verfassen von Uhren aus der animierten Eigenschaft entfernen, nachdem sie abgeschlossen wurden. Es gibt mehrere Möglichkeiten zum Entfernen einer Uhr:

• Wenn Sie alle Uhren aus einer Eigenschaft entfernen möchten, verwenden Sie die methode oder BeginAnimation(DependencyProperty, AnimationTimeline) die ApplyAnimationClock(DependencyProperty, AnimationClock) Methode des animierten Objekts. Geben Sie die Eigenschaft an, die als erster Parameter und null als zweite animiert wird. Dadurch werden alle Animationsuhren aus der Eigenschaft entfernt.

• Verwenden Sie zum Entfernen einer bestimmten AnimationClock Liste von Uhren die Controller Eigenschaft der AnimationClock zum Abrufen einer ClockController, und rufen Sie dann die Remove Methode der ClockController. Dies erfolgt in der Completed Regel im Ereignishandler für eine Uhr. Beachten Sie, dass nur Stammuhren von einer ClockController; die Controller Eigenschaft einer untergeordneten Uhr zurückgegeben nullwerden kann . 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 werden Removesoll.

Dies ist in erster Linie ein Problem bei Animationen für Objekte, die eine lange Lebensdauer aufweisen. Wenn ein Objekt garbage collection wird, werden die Uhren ebenfalls getrennt und garbage collection.

Weitere Informationen zu Uhrobjekten finden Sie unter Animation und Timing System Overview.