FrameworkContentElement.BeginStoryboard 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.
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie.
Surcharges
BeginStoryboard(Storyboard) |
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie. |
BeginStoryboard(Storyboard, HandoffBehavior) |
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie, avec les options spécifiées pour ce qui doit se produire si la propriété est déjà animée. |
BeginStoryboard(Storyboard, HandoffBehavior, Boolean) |
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie, avec l'état spécifié pour le contrôle de l'animation après qu'elle ait démarré. |
BeginStoryboard(Storyboard)
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie.
public:
void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard);
public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard);
member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard -> unit
Public Sub BeginStoryboard (storyboard As Storyboard)
Paramètres
- storyboard
- Storyboard
Table de montage séquentiel à lancer.
Remarques
Pour les signatures qui n’utilisent pas le isControllable
paramètre , ou lorsque ce paramètre est spécifié false
, les horloges chronologie associées à l’animation sont supprimées dès qu’elle atteint le point « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après avoir été exécutée une seule fois. Notez que le contrôle d’une animation nécessite également que le storyboard soit nommé ou accessible en tant que instance dans le code.
S’applique à
BeginStoryboard(Storyboard, HandoffBehavior)
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie, avec les options spécifiées pour ce qui doit se produire si la propriété est déjà animée.
public:
void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior);
public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior);
member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior -> unit
Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior)
Paramètres
- storyboard
- Storyboard
Table de montage séquentiel à lancer.
- handoffBehavior
- HandoffBehavior
Valeur de l'énumération qui décrit le comportement à adopter si une propriété décrite dans la table de montage séquentiel est déjà animée.
Remarques
Pour les signatures qui n’utilisent pas le isControllable
paramètre , ou lorsque ce paramètre est spécifié false
, les horloges chronologie associées à l’animation sont supprimées dès qu’elle atteint le point « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après avoir été exécutée une seule fois. Notez que le contrôle d’une animation nécessite également que le storyboard soit nommé ou accessible en tant que instance dans le code.
Utilisation de Compose HandoffBehavior
Lorsque vous appliquez un Storyboard, AnimationTimelineou AnimationClock à une propriété à l’aide de , tous Clock les ComposeHandoffBehaviorobjets 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.
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
null
comme deuxième. Cela supprime 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 n’est pas déclenché 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 la mémoire, 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 à
BeginStoryboard(Storyboard, HandoffBehavior, Boolean)
Commence la séquence d'actions contenues dans la table de montage séquentiel fournie, avec l'état spécifié pour le contrôle de l'animation après qu'elle ait démarré.
public:
void BeginStoryboard(System::Windows::Media::Animation::Storyboard ^ storyboard, System::Windows::Media::Animation::HandoffBehavior handoffBehavior, bool isControllable);
public void BeginStoryboard (System.Windows.Media.Animation.Storyboard storyboard, System.Windows.Media.Animation.HandoffBehavior handoffBehavior, bool isControllable);
member this.BeginStoryboard : System.Windows.Media.Animation.Storyboard * System.Windows.Media.Animation.HandoffBehavior * bool -> unit
Public Sub BeginStoryboard (storyboard As Storyboard, handoffBehavior As HandoffBehavior, isControllable As Boolean)
Paramètres
- storyboard
- Storyboard
Table de montage séquentiel à lancer.
- handoffBehavior
- HandoffBehavior
Valeur de l'énumération qui décrit le comportement à adopter si une propriété décrite dans la table de montage séquentiel est déjà animée.
- isControllable
- Boolean
Déclare si l'animation est contrôlable (peut être suspendue) après avoir démarré.
Remarques
Pour les signatures qui n’utilisent pas le isControllable
paramètre , ou lorsque ce paramètre est spécifié false
, les horloges chronologie associées à l’animation sont supprimées dès qu’elle atteint le point « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après avoir été exécutée une seule fois. Notez que le contrôle d’une animation nécessite également que le storyboard soit nommé ou accessible en tant que instance dans le code.
Utilisation de Compose HandoffBehavior
Lorsque vous appliquez un Storyboard, AnimationTimelineou AnimationClock à une propriété à l’aide de , ComposeHandoffBehaviortous 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
null
comme deuxième. Cela supprime 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 n’est pas déclenché 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 la mémoire, 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