FrameworkContentElement.BeginStoryboard Méthode

Définition

Commence la séquence d’actions contenues dans le storyboard fourni.

Surcharges

BeginStoryboard(Storyboard)

Commence la séquence d’actions contenues dans le storyboard fourni.

BeginStoryboard(Storyboard, HandoffBehavior)

Commence la séquence d’actions contenues dans le storyboard fourni, 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 le storyboard fourni, avec l’état spécifié pour le contrôle de l’animation après son démarrage.

BeginStoryboard(Storyboard)

Commence la séquence d’actions contenues dans le storyboard fourni.

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

Storyboard à commencer.

Remarques

Pour les signatures qui n’utilisent pas le isControllable, le paramètre ou lorsque ce paramètre est spécifié false, les horloges de chronologie associées à l’animation sont supprimées dès qu’elle atteint la période « 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 qu’instance dans le code.

S’applique à

BeginStoryboard(Storyboard, HandoffBehavior)

Commence la séquence d’actions contenues dans le storyboard fourni, 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

Storyboard à commencer.

handoffBehavior
HandoffBehavior

Valeur de l’énumération qui décrit le comportement à utiliser si une propriété décrite dans le storyboard est déjà animée.

Remarques

Pour les signatures qui n’utilisent pas le isControllable, le paramètre ou lorsque ce paramètre est spécifié false, les horloges de chronologie associées à l’animation sont supprimées dès qu’elle atteint la période « 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 qu’instance dans le code.

Utilisation de Compose HandoffBehavior

Lorsque vous appliquez un Storyboard, AnimationTimelineou AnimationClock à une propriété à l’aide de l'ComposeHandoffBehavior, tous les objets Clock 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 de Compose, vous devez supprimer les horloges de composition de la propriété animée une fois qu’elles ont été terminées. Il existe plusieurs façons de supprimer une horloge :

Il s’agit principalement d’un problème pour les animations sur les objets qui ont une longue durée de vie. Lorsqu’un objet est récupéré par la mémoire, ses horloges sont également déconnectées et collectées par le garbage.

Pour plus d’informations sur les objets horloge, consultez Vue d’ensemble de l’animation et du système de minutage.

S’applique à

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Commence la séquence d’actions contenues dans le storyboard fourni, avec l’état spécifié pour le contrôle de l’animation après son démarrage.

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

Storyboard à commencer.

handoffBehavior
HandoffBehavior

Valeur de l’énumération qui décrit le comportement à utiliser si une propriété décrite dans le storyboard est déjà animée.

isControllable
Boolean

Déclare si l’animation peut être contrôlable (peut être suspendue) après son démarrage.

Remarques

Pour les signatures qui n’utilisent pas le isControllable, le paramètre ou lorsque ce paramètre est spécifié false, les horloges de chronologie associées à l’animation sont supprimées dès qu’elle atteint la période « 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 qu’instance dans le code.

Utilisation de Compose HandoffBehavior

Lorsque vous appliquez un Storyboard, AnimationTimelineou AnimationClock à une propriété à l’aide de l'ComposeHandoffBehavior, tous les objets Clock 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 de Compose, vous devez supprimer les horloges de composition de la propriété animée une fois qu’elles ont été terminées. Il existe plusieurs façons de supprimer une horloge :

Il s’agit principalement d’un problème pour les animations sur les objets qui ont une longue durée de vie. Lorsqu’un objet est récupéré par la mémoire, ses horloges sont également déconnectées et collectées par le garbage.

Pour plus d’informations sur les objets horloge, consultez Vue d’ensemble de l’animation et du système de minutage.

S’applique à