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 do określonego DependencyProperty. AnimationClockApplies an AnimationClock to the specified DependencyProperty. Jeśli właściwość jest już animowana, SnapshotAndReplace używane jest zachowanie podczas przedania.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

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

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 ma ,wszystkieanimacjezostanąusuniętezokreślonejwłaściwości(aleniezatrzymane).nullIf handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). Jeśli handoffBehavior nulljest Compose i Clock ma, ta metoda nie ma żadnego 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 HandoffBehavior ustawień.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 Storyboardzastosowaniu Clock , AnimationTimeline, lub AnimationClock do właściwości przy użyciu Compose HandoffBehavior, wszystkie obiekty wcześniej skojarzone z tą właściwością nadal zużywają zasoby systemowe; system chronometrażu nie będzie Usuń te zegary automatycznie.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 Composeprogramu, należy usunąć z właściwości animowane zegary, 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