FrameworkElement.BeginStoryboard Méthode

Définition

Lance 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)

Lance la séquence d'actions contenues dans la table de montage séquentiel fournie, les options précisant ce qui doit se produire si la propriété est déjà animée.

BeginStoryboard(Storyboard, HandoffBehavior, Boolean)

Lance la séquence d'actions contenues dans la table de montage séquentiel fournie, avec un é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.

Exemples

L’exemple suivant récupère un Storyboard à partir de ressources, puis l’exécute Storyboard lorsqu’un événement interne est géré par la classe .

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim s As Storyboard

    s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
    Me.BeginStoryboard(s)
End Sub

Remarques

La plupart des scénarios d’animation classiques n’utilisent pas cette méthode. En règle générale, vous créez l’élément ou BeginStoryboard dans le Storyboard balisage, puis vous les placez en tant que EventTrigger contenu sur un élément. Lorsqu’elle est déclenchée par l’événement, l’animation s’exécute. La plupart des aspects de contrôle d’un Storyboard peuvent être traités par des propriétés exposées dans le balisage.

Pour les signatures qui n’utilisent pas le isControllableparamètre , ou lorsque ce paramètre est spécifié false, les horloges chronologie associées à l’animation sont supprimées dès que l’animation atteint la période « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après l’exécution d’une seule fois. Le contrôle d’une animation nécessite également que le storyboard dispose d’une directive x:Name ou qu’il soit accessible par référence dans le code.

S’applique à

BeginStoryboard(Storyboard, HandoffBehavior)

Lance la séquence d'actions contenues dans la table de montage séquentiel fournie, les options précisant 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.

Exemples

L’exemple suivant récupère un Storyboard à partir de ressources, puis l’exécute Storyboard lorsqu’un événement interne est géré par la classe .

private void OnImage1Animate(object sender, RoutedEventArgs e)
{
    Storyboard s;

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}
Private Sub OnImage1Animate(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim s As Storyboard

    s = CType(Me.FindResource("RotateStoryboard"), Storyboard)
    Me.BeginStoryboard(s)
End Sub

Remarques

La plupart des scénarios d’animation classiques n’utilisent pas cette méthode. En règle générale, vous créez l’élément ou BeginStoryboard dans le Storyboard balisage, puis vous les placez en tant que EventTrigger contenu sur un élément. Lorsqu’elle est déclenchée par l’événement, l’animation s’exécute. La plupart des aspects de contrôle d’un Storyboard peuvent être traités par des propriétés exposées dans le balisage.

Pour les signatures qui n’utilisent pas le isControllableparamètre , ou lorsque ce paramètre est spécifié false, les horloges chronologie associées à l’animation sont supprimées dès que l’animation atteint la période « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après l’exécution d’une seule fois. Le contrôle d’une animation nécessite également que le storyboard dispose d’une directive x:Name ou qu’il soit accessible par référence dans le code.

Le comportement de transfert peut être spécifié en tant qu’attribut de BeginStoryboard.

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 :

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)

Lance la séquence d'actions contenues dans la table de montage séquentiel fournie, avec un é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

La plupart des scénarios d’animation classiques n’utilisent pas cette méthode. En règle générale, vous créez l’élément ou BeginStoryboard dans le Storyboard balisage, puis vous les placez en tant que EventTrigger contenu sur un élément. Lorsqu’elle est déclenchée par l’événement, l’animation s’exécute. La plupart des aspects de contrôle d’un Storyboard peuvent être traités par des propriétés exposées dans le balisage.

Pour les signatures qui n’utilisent pas le isControllableparamètre , ou lorsque ce paramètre est spécifié false, les horloges chronologie associées à l’animation sont supprimées dès que l’animation atteint la période « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après l’exécution d’une seule fois. Le contrôle d’une animation nécessite également que le storyboard dispose d’une directive x:Name ou qu’il soit accessible par référence dans le code.

Le comportement de transfert peut être spécifié en tant qu’attribut de BeginStoryboard.

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 :

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 à