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

Définition

Anime la propriété DependencyProperty spécifiée à l'aide de l'horloge AnimationClock spécifiée.Animates the specified DependencyProperty using the specified AnimationClock.

Surcharges

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

Applique AnimationClock au DependencyProperty spécifié.Applies an AnimationClock to the specified DependencyProperty. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

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

Applique AnimationClock au DependencyProperty spécifié.Applies an AnimationClock to the specified DependencyProperty. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.If the property is already animated, the specified HandoffBehavior is used.

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

Applique AnimationClock au DependencyProperty spécifié.Applies an AnimationClock to the specified DependencyProperty. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.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)

Paramètres

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propriété à animer.The property to animate.

clock
AnimationClock AnimationClock AnimationClock AnimationClock

Horloge avec laquelle animer la propriété spécifiée.The clock with which to animate the specified property. Si clock a la valeur null, toutes les animations sont supprimées de la propriété spécifiée (mais pas arrêtées).If clock is null, all animations will be removed from the specified property (but not stopped).

Implémente

Remarques

Notez que l’utilisation de cette méthode pour supprimer les horloges d’une propriété n’arrête pas ces horloges.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)

Applique AnimationClock au DependencyProperty spécifié.Applies an AnimationClock to the specified DependencyProperty. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.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

Paramètres

dp
DependencyProperty DependencyProperty DependencyProperty DependencyProperty

Propriété à animer.The property to animate.

clock
AnimationClock AnimationClock AnimationClock AnimationClock

Horloge avec laquelle animer la propriété spécifiée.The clock with which to animate the specified property. Si le comportement handoffBehavior correspond à SnapshotAndReplace si clock a la valeur null, toutes les animations seront supprimées de la propriété spécifiée (mais non arrêtées).If handoffBehavior is SnapshotAndReplace and clock is null, all animations will be removed from the specified property (but not stopped). Si le comportement handoffBehavior est Compose et si l'horloge a la valeur null, cette méthode est sans effet.If handoffBehavior is Compose and clock is null, this method has no effect.

handoffBehavior
HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior

Valeur qui spécifie comment la nouvelle animation doit interagir avec les animations en cours, affectant déjà la valeur de propriété.A value that specifies how the new animation should interact with any current animations already affecting the property value.

Implémente

Exemples

L’exemple suivant montre comment appliquer des horloges d’animation HandoffBehavior à l’aide de différents paramètres.The following example shows how to apply animation clocks using different HandoffBehavior settings.

Remarques

Notez que l’utilisation de cette méthode pour supprimer les horloges d’une propriété n’arrête pas ces horloges.Note that using this method to remove clocks from a property does not stop those clocks.

Utilisation du message HandoffBehavior composeUsing the Compose HandoffBehavior

Quand vous appliquez un Storyboard, AnimationTimelineun ou AnimationClock à une propriété à l' Compose aide HandoffBehaviorde Clock , tous les objets précédemment associés à cette propriété continuent à consommer des ressources système; le système de minutage ne Supprimez ces horloges automatiquement.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.

Pour éviter les problèmes de performances lorsque vous appliquez un grand nombre d' Composehorloges à l’aide de, vous devez supprimer la composition des horloges de la propriété animée une fois qu’elles sont terminées.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. Il existe plusieurs manières de supprimer une horloge.There are several ways to remove a clock.

Il s’agit principalement d’un problème pour les animations sur des objets qui ont une durée de vie longue.This is primarily an issue for animations on objects that have a long lifetime. Lorsqu’un objet est récupéré par le garbage collector, ses horloges sont également déconnectées et récupérées.When an object is garbage collected, its clocks will also be disconnected and garbage collected.

Pour plus d’informations sur les objets Clock, consultez vue d’ensemble du système d’animation et de minutage.For more information about clock objects, see the Animation and Timing System Overview.

S’applique à