Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

FrameworkElement.BeginStoryboard méthode (Storyboard, HandoffBehavior)

 

Date de publication : novembre 2016

Commence la séquence d’actions contenues dans la table de montage séquentiel fournie, avec les options spécifiées pour ce qui se passerait si la propriété est déjà animée.

Espace de noms:   System.Windows
Assembly:  PresentationFramework (dans PresentationFramework.dll)

public void BeginStoryboard(
	Storyboard storyboard,
	HandoffBehavior handoffBehavior
)

Paramètres

storyboard
Type: System.Windows.Media.Animation.Storyboard

La table de montage séquentiel pour commencer.

handoffBehavior
Type: System.Windows.Media.Animation.HandoffBehavior

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

Scénarios les plus courants animation n’utilisent pas cette méthode. En général, vous créez le Storyboard ou BeginStoryboard élément dans le balisage, puis le placer comme le EventTrigger contenu sur un élément. Au déclenchement de l’événement, l’animation s’exécute. La plupart des aspects de contrôle d’un Storyboard peuvent être adressés par les propriétés qui sont exposées dans le balisage.

Pour les signatures qui n’utilisent pas le isControllable, paramètre, ou lorsque ce paramètre est spécifié false, les chronologies de minutage associées à l’animation sont supprimées dès qu’elle atteint la période de « Remplissage ». Par conséquent, l’animation ne peut pas être redémarrée après avoir exécuté une seule fois. Contrôle d’une animation requiert également que la table de montage séquentiel a un x:Name Directive ou soit accessible par référence dans le code.

Comportement de transfert peut être spécifié comme attribut de BeginStoryboard.

Lorsque vous appliquez un Storyboard, AnimationTimeline, ou AnimationClock à une propriété à l’aide de la Compose HandoffBehavior, tout Clock objets précédemment associés à cette propriété continuent d’utiliser les ressources système ; le système de minuterie ne supprime pas les horloges automatiquement. 

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 lorsqu’ils ont terminé. Il existe plusieurs manières 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 par le garbage collecté, ses horloges sont également déconnectées et récupérées.

Pour plus d’informations sur les objets clock, consultez Animation and Timing System Overview.

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

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

    s = (Storyboard)this.FindResource("RotateStoryboard");
    this.BeginStoryboard(s);
}

.NET Framework
Disponible depuis 3.0
Retour au début
Afficher: