BeginStoryboard.HandoffBehavior Propriété
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.
Obtient ou définit le comportement de transfert approprié pour démarrer une horloge d’animation dans ce plan conceptuel.
public:
property System::Windows::Media::Animation::HandoffBehavior HandoffBehavior { System::Windows::Media::Animation::HandoffBehavior get(); void set(System::Windows::Media::Animation::HandoffBehavior value); };public System.Windows.Media.Animation.HandoffBehavior HandoffBehavior { get; set; }member this.HandoffBehavior : System.Windows.Media.Animation.HandoffBehavior with get, setPublic Property HandoffBehavior As HandoffBehaviorValeur de propriété
Une des valeurs d'énumération HandoffBehavior. La valeur par défaut est SnapshotAndReplace.
Remarques
Utilisation de Compose HandoffBehavior
Lorsque vous appliquez une Storyboardpropriété , AnimationTimelineou AnimationClock à une propriété à l’aide HandoffBehavior.Composede , tous 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 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 façons 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
nullcomme 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 de ClockController. Cela se fait généralement 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 n’est 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 collecté à la mémoire, ses horloges sont également déconnectées et ramassées.
Pour plus d’informations sur les objets d’horloge, consultez Animation et Vue d’ensemble du système de minutage.
