Animatable.ApplyAnimationClock Metoda

Definicja

Animowanie określonego DependencyProperty przy użyciu określonego AnimationClock.Animates the specified DependencyProperty using the specified AnimationClock.

Przeciążenia

ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje AnimationClock do określonego DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, używane jest zachowanie SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Stosuje AnimationClock do określonego DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior.If the property is already animated, the specified HandoffBehavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Stosuje AnimationClock do określonego DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, używane jest zachowanie SnapshotAndReplace.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)

Parametry

dp
DependencyProperty

Właściwość do animacji.The property to animate.

clock
AnimationClock

Zegar, za pomocą którego ma być animowana określona właściwość.The clock with which to animate the specified property. Jeśli clock jest null, wszystkie animacje zostaną usunięte z określonej właściwości (ale nie zatrzymane).If clock is null, all animations will be removed from the specified property (but not stopped).

Implementuje

Uwagi

Należy zauważyć, że użycie tej metody do usuwania zegarów z właściwości nie powoduje zatrzymania tych zegarów.Note that using this method to removing clocks from a property does not stop those clocks.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Stosuje AnimationClock do określonego DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, zostanie użyta określona HandoffBehavior.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
Public Sub ApplyAnimationClock (dp As DependencyProperty, clock As AnimationClock, handoffBehavior As HandoffBehavior)

Parametry

dp
DependencyProperty

Właściwość do animacji.The property to animate.

clock
AnimationClock

Zegar, za pomocą którego ma być animowana określona właściwość.The clock with which to animate the specified property. Jeśli handoffBehavior jest SnapshotAndReplace i clock jest null, wszystkie animacje zostaną usunięte z określonej właściwości (ale nie zatrzymane).If handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). Jeśli handoffBehavior jest Compose i zegar jest null, ta metoda nie ma wpływu.If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior

Wartość określająca sposób, w jaki Nowa animacja powinna współdziałać z wszystkimi bieżącymi animacjami, które mają już wpływ na wartość właściwości.A value that specifies how the new animation should interact with any current animations already affecting the property value.

Implementuje

Przykłady

Poniższy przykład pokazuje, jak zastosować zegary animacji przy użyciu różnych ustawień HandoffBehavior.The following example shows how to apply animation clocks using different HandoffBehavior settings.

Uwagi

Należy zauważyć, że użycie tej metody do usuwania zegarów z właściwości nie powoduje zatrzymania tych zegarów.Note that using this method to remove clocks from a property does not stop those clocks.

Korzystanie z Compose HandoffBehaviorUsing the Compose HandoffBehavior

Po zastosowaniu Storyboard, AnimationTimelinelub AnimationClock do właściwości przy użyciu Compose HandoffBehaviorwszystkie obiekty Clock wcześniej skojarzone z tą właściwością nadal zużywają zasoby systemowe; System chronometrażu nie spowoduje automatycznego usunięcia tych zegarów.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.

Aby uniknąć problemów z wydajnością podczas stosowania dużej liczby zegarów przy użyciu Compose, należy usunąć zegary redagowania z właściwości animowanej po ich zakończeniu.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. Istnieje kilka sposobów usunięcia zegara.There are several ways to remove a clock.

Jest to szczególnie problem w przypadku animacji na obiektach, które mają długi okres istnienia.This is primarily an issue for animations on objects that have a long lifetime. Gdy obiekt jest odzyskiwany, jego zegary również zostaną rozłączone i zostaną pobrane jako elementy bezużyteczne.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

Aby uzyskać więcej informacji na temat obiektów zegara, zobacz Omówienie animacji i systemu chronometrażu.For more information about clock objects, see the Animation and Timing System Overview.

Dotyczy