Animatable.ApplyAnimationClock Animatable.ApplyAnimationClock Animatable.ApplyAnimationClock Animatable.ApplyAnimationClock Method

Definition

Animiert die angegebene DependencyProperty mit der angegebenen AnimationClock.Animates the specified DependencyProperty using the specified AnimationClock.

Überlädt

ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock)

Wendet einen AnimationClock auf die angegebene DependencyProperty an.Applies an AnimationClock to the specified DependencyProperty. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Wendet einen AnimationClock auf die angegebene DependencyProperty an.Applies an AnimationClock to the specified DependencyProperty. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet.If the property is already animated, the specified HandoffBehavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock) ApplyAnimationClock(DependencyProperty, AnimationClock)

Wendet einen AnimationClock auf die angegebene DependencyProperty an.Applies an AnimationClock to the specified DependencyProperty. Wenn die Eigenschaft bereits animiert wird, wird das SnapshotAndReplace-Übergabeverhalten verwendet.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock);
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock);
abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock -> unit
Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock)

Parameter

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Die zu animierende Eigenschaft.The property to animate.

clock
AnimationClock AnimationClock AnimationClock AnimationClock

Der Takt, mit dem die angegebene Eigenschaft animiert werden soll.The clock with which to animate the specified property. Wenn clock gleich null ist, werden alle Animationen aus der angegebenen Eigenschaft entfernt (jedoch nicht angehalten).If clock is null, all animations will be removed from the specified property (but not stopped).

Implementiert

Hinweise

Beachten Sie, dass die Uhren mit dieser Methode zum Entfernen von Uhren aus einer Eigenschaft nicht angehalten werden.Note that using this method to removing clocks from a property does not stop those clocks.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Wendet einen AnimationClock auf die angegebene DependencyProperty an.Applies an AnimationClock to the specified DependencyProperty. Wenn die Eigenschaft bereits animiert wird, wird das angegebene HandoffBehavior verwendet.If the property is already animated, the specified HandoffBehavior is used.

public:
 virtual void ApplyAnimationClock(System::Windows::DependencyProperty ^ dp, System::Windows::Media::Animation::AnimationClock ^ clock, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);
public void ApplyAnimationClock (System.Windows.DependencyProperty dp, System.Windows.Media.Animation.AnimationClock clock, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);
abstract member ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit
override this.ApplyAnimationClock : System.Windows.DependencyProperty * System.Windows.Media.Animation.AnimationClock * System.Windows.Media.Animation.HandoffBehavior -> unit

Parameter

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Die zu animierende Eigenschaft.The property to animate.

clock
AnimationClock AnimationClock AnimationClock AnimationClock

Der Takt, mit dem die angegebene Eigenschaft animiert werden soll.The clock with which to animate the specified property. Wenn handoffBehavior den Wert SnapshotAndReplace aufweist und clocknull ist, werden alle Animationen aus der angegebenen Eigenschaft entfernt (jedoch nicht angehalten).If handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). Wenn für handoffBehavior der Wert Compose festgelegt ist und clock null ist, hat diese Methode keine Auswirkungen.If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

Ein Wert, der angibt, wie die neue Animation ggf. mit aktuellen Animationen interagieren soll, die sich bereits auf den Eigenschaftswert auswirken.A value that specifies how the new animation should interact with any current animations already affecting the property value.

Implementiert

Beispiele

Das folgende Beispiel zeigt, wie Sie mithilfe verschiedener Animationsuhren anwenden HandoffBehavior Einstellungen.The following example shows how to apply animation clocks using different HandoffBehavior settings.

Hinweise

Beachten Sie, dass es sich bei Verwendung dieser Methode zum Entfernen von Uhren aus einer Eigenschaft die Uhren nicht angehalten werden.Note that using this method to remove clocks from a property does not stop those clocks.

Mithilfe der Compose HandoffBehaviorUsing the Compose HandoffBehavior

Beim Anwenden einer Storyboard, AnimationTimeline, oder AnimationClock auf eine Eigenschaft mit der Compose HandoffBehavior, Clock Objekte, die diese Eigenschaft zuvor zugeordnet waren weiterhin Systemressourcen beanspruchen, nicht der Fall ist des Zeitsteuerungssystems Diese Uhren automatisch entfernt.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system will not remove these clocks automatically.

Um Leistungsprobleme zu vermeiden, wenn Sie eine große Anzahl von Uhren mithilfe anwenden Compose, sollten Sie zusammengesetzte Uhren aus der animierten Eigenschaft entfernen, nachdem sie ausgeführt.To avoid performance issues when you apply a large number of clocks using Compose, you should remove composing clocks from the animated property after they complete. Es gibt mehrere Möglichkeiten, eine Uhr zu entfernen.There are several ways to remove a clock.

Dies betrifft hauptsächlich Animationen für Objekte, die eine lange Lebensdauer haben.This is primarily an issue for animations on objects that have a long lifetime. Wenn ein Objekt an den Garbage Collector übergeben wird, werden auch die Uhren getrennt und an den Garbage Collector übergeben.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

Weitere Informationen zu uhrobjekten finden Sie unter den Animation und zeitliche Steuerung Systemübersicht.For more information about clock objects, see the Animation and Timing System Overview.

Gilt für: