HandoffBehavior Énumération
Définition
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 HandoffBehavior
public enum HandoffBehavior
type HandoffBehavior =
Public Enum HandoffBehavior
- Héritage
Champs
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. |
Remarques
Lorsque vous appliquez un Storyboard, AnimationTimelineun ou AnimationClock à une propriété à l’aide de compose, Clock les objets précédemment associés à cette propriété continuent à consommer des ressources système; le système de minutage ne supprime pas les horloges systématiquement.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é, ApplyAnimationClock(DependencyProperty, AnimationClock) utilisez BeginAnimation(DependencyProperty, AnimationTimeline) la méthode ou 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
null
la seconde.Specify the property being animated as the first parameter, andnull
as 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 spécifique AnimationClock d’une liste d’horloges, utilisez Controller la propriété du AnimationClock pour récupérer ClockControllerun ClockController, puis appelez la Remove méthode de.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 Completed gestionnaire d’événements 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 Controller un ClockController; la propriété d’une
null
horloge enfant retourne.Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock returnsnull
. Notez également que l' Completed événement 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.