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

Definizione

Aggiunge un'animazione all'oggetto DependencyProperty specificato utilizzando l'oggetto AnimationClock indicato.Animates the specified DependencyProperty using the specified AnimationClock.

Overload

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

Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato.Applies an AnimationClock to the specified DependencyProperty. Se la proprietà è già animata, viene usato il comportamento di continuità di SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

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

Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato.Applies an AnimationClock to the specified DependencyProperty. Se alla proprietà è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato.If the property is already animated, the specified HandoffBehavior is used.

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

Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato.Applies an AnimationClock to the specified DependencyProperty. Se la proprietà è già animata, viene usato il comportamento di continuità di 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)

Parametri

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Proprietà a cui applicare l'animazione.The property to animate.

clock
AnimationClock AnimationClock AnimationClock AnimationClock

Clock su cui basare l'animazione aggiunta alla proprietà specificata.The clock with which to animate the specified property. Se clock è null, tutte le animazioni verranno rimosse dalla proprietà specificata (ma non interrotte).If clock is null, all animations will be removed from the specified property (but not stopped).

Implementazioni

Commenti

Si noti che l'utilizzo di questo metodo per rimuovere orologi da una proprietà non interrompe tali orologi.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)

Applica un oggetto AnimationClock all'oggetto DependencyProperty specificato.Applies an AnimationClock to the specified DependencyProperty. Se alla proprietà è già stata aggiunta un'animazione, viene utilizzato l'oggetto HandoffBehavior specificato.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

Parametri

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Proprietà a cui applicare l'animazione.The property to animate.

clock
AnimationClock AnimationClock AnimationClock AnimationClock

Clock su cui basare l'animazione aggiunta alla proprietà specificata.The clock with which to animate the specified property. Se handoffBehavior è SnapshotAndReplace e clock è null, tutte le animazioni verranno rimosse dalla proprietà specificata (ma non interrotte).If handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). Se handoffBehavior è Compose e il clock è null, questo metodo non ha effetto.If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

Valore che specifica il modo in cui la nuova animazione deve interagire con tutte le animazioni correnti che già influiscono sul valore della proprietà.A value that specifies how the new animation should interact with any current animations already affecting the property value.

Implementazioni

Esempi

Nell'esempio seguente viene illustrato come applicare orologi di animazione utilizzando impostazioni HandoffBehavior diverse.The following example shows how to apply animation clocks using different HandoffBehavior settings.

Commenti

Si noti che l'utilizzo di questo metodo per rimuovere orologi da una proprietà non interrompe tali orologi.Note that using this method to remove clocks from a property does not stop those clocks.

Uso di Compose HandoffBehaviorUsing the Compose HandoffBehavior

Quando si applica un Storyboard, AnimationTimelineo AnimationClock a una proprietà utilizzando Compose HandoffBehavior, tutti Clock gli oggetti associati in precedenza a tale proprietà continuano a utilizzare le risorse di sistema. il sistema di temporizzazione non verrà rimuovere gli orologi automaticamente.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.

Per evitare problemi di prestazioni quando si applica un numero elevato di orologi usando Compose, è necessario rimuovere gli orologi di composizione dalla proprietà animata dopo che sono stati completati.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. Esistono diverse modalità di rimozione di un orologio.There are several ways to remove a clock.

Si tratta principalmente di un problema relativo alle animazioni su oggetti di lunga durata.This is primarily an issue for animations on objects that have a long lifetime. Quando un oggetto viene raccolto nel Garbage Collector, anche gli orologi vengono disconnessi e raccolti nel Garbage Collector stesso.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

Per ulteriori informazioni sugli oggetti Clock, vedere Cenni preliminari sull'animazione e sul sistemadi temporizzazione.For more information about clock objects, see the Animation and Timing System Overview.

Si applica a