FrameworkContentElement.BeginStoryboard Méthode

Définition

Commence la séquence d'actions contenues dans la table de montage séquentiel fournie.Begins the sequence of actions that are contained in the provided storyboard.

Surcharges

BeginStoryboard(Storyboard)

Commence la séquence d'actions contenues dans la table de montage séquentiel fournie.Begins the sequence of actions that are contained in the provided storyboard.

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.Begins the sequence of actions that are contained in the provided storyboard, with options specified for what should occur if the property is already animated.

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é.Begins the sequence of actions that are contained in the provided storyboard, with specified state for control of the animation after it is started.

BeginStoryboard(Storyboard)

Commence la séquence d'actions contenues dans la table de montage séquentiel fournie.Begins the sequence of actions that are contained in the provided storyboard.

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.The storyboard to begin.

Remarques

Pour les signatures qui n’utilisent pas le isControllable paramètre, ou lorsque ce paramètre est spécifié false , les horloges de la chronologie associées à l’animation sont supprimées dès qu’il atteint la période de « remplissage ».For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. Par conséquent, l’animation ne peut pas être redémarrée après avoir été exécutée une seule fois.Therefore the animation cannot be restarted after being run once. Notez que le contrôle d’une animation requiert également que la table de montage séquentiel soit nommée ou accessible en tant qu’instance dans le code.Note that controlling an animation also requires that the storyboard be named or accessible as an instance in 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.Begins the sequence of actions that are contained in the provided storyboard, with options specified for what should occur if the property is already animated.

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.The storyboard to begin.

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.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

Remarques

Pour les signatures qui n’utilisent pas le isControllable paramètre, ou lorsque ce paramètre est spécifié false , les horloges de la chronologie associées à l’animation sont supprimées dès qu’il atteint la période de « remplissage ».For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. Par conséquent, l’animation ne peut pas être redémarrée après avoir été exécutée une seule fois.Therefore the animation cannot be restarted after being run once. Notez que le contrôle d’une animation requiert également que la table de montage séquentiel soit nommée ou accessible en tant qu’instance dans le code.Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

Utilisation du message HandoffBehavior composeUsing the Compose HandoffBehavior

Quand vous appliquez Storyboard , AnimationTimeline ou AnimationClock à une propriété à l’aide de Compose HandoffBehavior , tous les Clock objets 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 the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does 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 by 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:

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 par le garbage collector.When an object is garbage collected, its clocks are also 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.

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é.Begins the sequence of actions that are contained in the provided storyboard, with specified state for control of the animation after it is started.

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.The storyboard to begin.

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.A value of the enumeration that describes behavior to use if a property described in the storyboard is already animated.

isControllable
Boolean

Déclare si l'animation est contrôlable (peut être suspendue) après avoir démarré.Declares whether the animation is controllable (can be paused) after it is started.

Remarques

Pour les signatures qui n’utilisent pas le isControllable paramètre, ou lorsque ce paramètre est spécifié false , les horloges de la chronologie associées à l’animation sont supprimées dès qu’il atteint la période de « remplissage ».For the signatures that do not use the isControllable, parameter, or when that parameter is specified false, the timeline clocks associated with the animation are removed as soon as it reaches the "Fill" period. Par conséquent, l’animation ne peut pas être redémarrée après avoir été exécutée une seule fois.Therefore the animation cannot be restarted after being run once. Notez que le contrôle d’une animation requiert également que la table de montage séquentiel soit nommée ou accessible en tant qu’instance dans le code.Note that controlling an animation also requires that the storyboard be named or accessible as an instance in code.

Utilisation du message HandoffBehavior composeUsing the Compose HandoffBehavior

Quand vous appliquez Storyboard , AnimationTimeline ou AnimationClock à une propriété à l’aide de Compose HandoffBehavior , tous les Clock objets précédemment associés à cette propriété continuent à consommer des ressources système ; le système de minutage ne supprime pas ces horloges automatiquement.When you apply a Storyboard, AnimationTimeline, or AnimationClock to a property by using the Compose HandoffBehavior, any Clock objects previously associated with that property continue to consume system resources; the timing system does not remove these 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 by 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:

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 par le garbage collector.When an object is garbage collected, its clocks are also 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.

S’applique à