Animatable.ApplyAnimationClock Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Anime la propriété DependencyProperty spécifiée à l'aide de l'horloge AnimationClock spécifiée.
Surcharges
ApplyAnimationClock(DependencyProperty, AnimationClock) |
Applique AnimationClock au DependencyProperty spécifié. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé. |
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Applique AnimationClock au DependencyProperty spécifié. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé. |
ApplyAnimationClock(DependencyProperty, AnimationClock)
Applique AnimationClock au DependencyProperty spécifié. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.
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
Propriété à animer.
- clock
- AnimationClock
Horloge avec laquelle animer la propriété spécifiée. Si clock
a la valeur null
, toutes les animations sont supprimées de la propriété spécifiée (mais pas arrêtées).
Implémente
Remarques
Notez que l’utilisation de cette méthode pour supprimer des horloges d’une propriété n’arrête pas ces horloges.
S’applique à
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)
Applique AnimationClock au DependencyProperty spécifié. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.
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)
Paramètres
Propriété à animer.
- clock
- AnimationClock
Horloge avec laquelle animer la propriété spécifiée. 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). Si le comportement handoffBehavior
est Compose et si l'horloge a la valeur null
, cette méthode est sans effet.
- 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é.
Implémente
Exemples
L’exemple suivant montre comment appliquer des horloges d’animation à l’aide de paramètres différents HandoffBehavior .
Remarques
Notez que l’utilisation de cette méthode pour supprimer des horloges d’une propriété n’arrête pas ces horloges.
Utilisation de Compose HandoffBehavior
Lorsque vous appliquez un Storyboard, AnimationTimelineou AnimationClock à une propriété à l’aide de ComposeHandoffBehavior, les Clock objets précédemment associés à cette propriété continuent à consommer des ressources système ; le système de minutage ne supprime pas automatiquement ces horloges.
Pour éviter les problèmes de performances lorsque vous appliquez un grand nombre d’horloges à l’aide Composede , vous devez supprimer les horloges de composition de la propriété animée une fois qu’elles sont terminées. Il existe plusieurs manières de supprimer une horloge.
Pour supprimer toutes les horloges d’une propriété, utilisez la ApplyAnimationClock(DependencyProperty, AnimationClock) méthode ou BeginAnimation(DependencyProperty, AnimationTimeline) de l’objet animé. Spécifiez la propriété animée comme premier paramètre et
null
comme deuxième. Cela supprimera toutes les horloges d’animation de la propriété.Pour supprimer un spécifique AnimationClock d’une liste d’horloges, utilisez la Controller propriété de AnimationClock pour récupérer un ClockController, puis appelez la Remove méthode du ClockController. Cette opération est généralement effectuée dans le gestionnaire d’événements Completed d’une horloge. Notez que seules les horloges racines peuvent être contrôlées par un ClockController; la Controller propriété d’une horloge enfant retourne
null
. Notez également que l’événement Completed ne sera pas appelé si la durée effective de l’horloge est éternelle. Dans ce cas, l’utilisateur doit déterminer quand appeler Remove.
Il s’agit principalement d’un problème pour les animations sur des objets qui ont une durée de vie longue. Lorsqu’un objet est récupéré par le garbage collector, ses horloges sont également déconnectées et récupérées.
Pour plus d’informations sur les objets d’horloge, consultez Vue d’ensemble du système d’animation et de minutage.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour