HandoffBehavior HandoffBehavior HandoffBehavior HandoffBehavior Enum

Définition

public enum class HandoffBehavior

public enum HandoffBehavior

type HandoffBehavior = 

Public Enum HandoffBehavior

Héritage

ObjectObjectObjectObject

ValueTypeValueTypeValueTypeValueType

EnumEnumEnumEnum

HandoffBehaviorHandoffBehaviorHandoffBehaviorHandoffBehavior

Champs

Remarques

Lorsque vous appliquez un Storyboard, AnimationTimeline, ou AnimationClock à une propriété à l’aide de Compose, toute Clock objets précédemment associés à cette propriété continuent de consommer des ressources système ; le système de minutage ne supprimera pas les horloges automatiquement.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 du nouveau message, vous devez supprimer les horloges à partir de la propriété animée lorsqu’elles ont terminé.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 le ApplyAnimationClock(DependencyProperty, AnimationClock) ou BeginAnimation(DependencyProperty, AnimationTimeline) méthode 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 en tant que la seconde.Specify the property being animated as the first parameter, and null 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 à partir d’une liste d’horloges, utilisez la Controller propriété de la AnimationClock pour récupérer un ClockController, puis appelez le Remove méthode de la 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 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 un ClockController; le Controller propriété d’une horloge enfant retourne null.Note that only root clocks can be controlled by a ClockController; the Controller property of a child clock returns null. Notez également que le 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 Animation et vue d’ensemble du système de minutage.For more information about clock objects, see Animation and Timing System Overview.

S’applique à