HandoffBehavior Enum
Definition
Spécifie la façon dont les nouvelles animations interagissent avec les animations existantes qui sont déjà appliquées à une propriété.Specifies how new animations interact with any existing ones that are already applied to a property.
public enum class HandoffBehaviorpublic enum HandoffBehaviortype HandoffBehavior = Public Enum HandoffBehavior- Inheritance
Fields
| Compose | 1 | Pour combiner les nouvelles animations à celles existantes, les nouvelles animations sont ajoutées à la fin de la chaîne de composition.New animations are combined with existing animations by appending the new animations to the end of the composition chain. |
| SnapshotAndReplace | 0 | Les nouvelles animations remplacent les animations existantes sur les propriétés auxquelles elles sont appliquées.New animations replace any existing animations on the properties to which they are applied. |
Remarks
Lorsque vous appliquez une Storyboard, AnimationTimelineou AnimationClock à une propriété à l’aide de compose, tous les objets Clock précédemment associés à cette propriété continuent à consommer des ressources système. le système de minutage ne supprime pas automatiquement les horloges.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using Compose, any Clock objects previously associated with that property continue to consume system resources; the timing system will not remove the clocks automatically.
Pour éviter les problèmes de performances lorsque vous appliquez un grand nombre d’horloges à l’aide de compose, 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 façons de supprimer une horloge :There are several ways to remove a clock:
Pour supprimer toutes les horloges d’une propriété, utilisez la méthode ApplyAnimationClock(DependencyProperty, AnimationClock) ou BeginAnimation(DependencyProperty, AnimationTimeline) de l’objet animé.To remove all clocks from a property, use the ApplyAnimationClock(DependencyProperty, AnimationClock) or BeginAnimation(DependencyProperty, AnimationTimeline) method of the animated object. Spécifiez la propriété animée comme premier paramètre et
nullcomme deuxième paramètre.Specify the property being animated as the first parameter, andnullas the second. Cela supprimera toutes les horloges d’animation de la propriété.This will remove all animation clocks from the property.Pour supprimer un AnimationClock spécifique d’une liste d’horloges, utilisez la propriété Controller du AnimationClock pour récupérer un ClockController, puis appelez la méthode Remove de l' ClockController.To remove a specific AnimationClock from a list of clocks, use the Controller property of the AnimationClock to retrieve a ClockController, then call the Remove method of the ClockController. Cela s’effectue généralement dans le gestionnaire d’événements Completed pour une horloge.This is typically done in the Completed event handler for a clock. Notez que seules les horloges racine peuvent être contrôlées par un ClockController; la propriété Controller d’une horloge enfant retourne
null.Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock returnsnull. Notez également que l’événement Completed n’est pas déclenché si la durée effective de l’horloge est illimitée.Note also that the Completed event will not be raised if the effective duration of the clock is forever. Dans ce cas, l’utilisateur doit déterminer quand appeler Remove.In that case, the user must determine when to call Remove.
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 Animation and Timing System Overview.