Partager via


Storyboard Classe

Définition

Chronologie de conteneur qui fournit des informations sur le ciblage des objets et des propriétés pour ses animations enfants.

public ref class Storyboard : System::Windows::Media::Animation::ParallelTimeline
public class Storyboard : System.Windows.Media.Animation.ParallelTimeline
type Storyboard = class
    inherit ParallelTimeline
Public Class Storyboard
Inherits ParallelTimeline
Héritage

Remarques

Contrôle interactif des storyboards

Un storyboard contrôlable peut être mis en pause, reprendre, rechercher, arrêter et être supprimé. Pour rendre un storyboard contrôlable dans le balisage, vous spécifiez la Name propriété de l’objet qui le BeginStoryboard crée. Pour obtenir un exemple, voir How to: Use Event Triggers to Control a Storyboard After It Starts. Pour rendre un storyboard contrôlable dans le code, vous devez utiliser la surcharge appropriée de la méthode du Begin storyboard et spécifier true pour la rendre contrôlable. Pour obtenir un exemple, consultez Guide pratique pour contrôler un storyboard après son démarrage.

Liaison de données et animation de chronologies

La plupart des propriétés chronologie peuvent être liées aux données ou animées. Toutefois, en raison du fonctionnement du système de minutage, les chronologies liées aux données ou animées ne se comportent pas comme d’autres objets liés aux données ou animés. Pour comprendre leur comportement, il est utile de comprendre ce que signifie l’activation d’un chronologie.

Lorsqu’un chronologie est activé, des copies sont effectuées de l’chronologie et de ses chronologies enfants. Ces copies sont figées (en lecture seule) et Clock les objets sont créés à partir de celles-ci. Ces horloges effectuent le travail réel de l’animation des propriétés ciblées. Si un chronologie est lié aux données ou animé, une instantané de ses valeurs actuelles est effectuée lors de la création de son horloge. Même si le chronologie d’origine peut continuer à changer, son horloge ne le fait pas.

Pour qu’une chronologie reflète les modifications de liaison de données ou d’animation, son horloge doit être recréé. Les horloges ne sont pas recréations automatiquement pour vous. Voici plusieurs façons d’appliquer des modifications de chronologie :

  • Si le chronologie est ou appartient à un Storyboard, vous pouvez lui faire refléter les modifications en réappliquer son storyboard à l’aide Begin d’une BeginStoryboard méthode ou . Cela a pour effet secondaire de redémarrer également l’animation. Dans le code, vous pouvez utiliser la Seek méthode pour faire remonter le storyboard à sa position précédente.

  • Si vous avez appliqué une animation directement à une propriété à l’aide de la BeginAnimation méthode, appelez à nouveau la BeginAnimation méthode et transmettez-lui l’animation qui a été modifiée.

  • Si vous travaillez directement au niveau de l’horloge, créez et appliquez un nouveau jeu d’horloges et utilisez-les pour remplacer l’ensemble précédent d’horloges créées.

Pour obtenir un exemple d’animation liée aux données, consultez Key Spline Animation Sample .

Constructeurs

Storyboard()

Initialise une nouvelle instance de la classe Storyboard.

Champs

TargetNameProperty

Identifie la propriété jointe TargetName.

TargetProperty

Identifie la propriété jointe Target.

TargetPropertyProperty

Identifie la propriété jointe TargetProperty.

Propriétés

AccelerationRatio

Obtient ou définit une valeur spécifiant le pourcentage de Duration de la chronologie consacré à l’accélération du passage du temps de zéro à sa vitesse maximale.

(Hérité de Timeline)
AutoReverse

Obtient ou définit une valeur qui indique si la chronologie est lue en sens inverse après avoir effectué une itération vers l’avant.

(Hérité de Timeline)
BeginTime

Obtient ou définit l’heure à laquelle ce Timeline doit commencer.

(Hérité de Timeline)
CanFreeze

Obtient une valeur qui indique si l’objet peut être rendu non modifiable.

(Hérité de Freezable)
Children

Obtient ou définit la collection d’objets Timeline enfants directs de TimelineGroup.

(Hérité de TimelineGroup)
DecelerationRatio

Obtient ou définit une valeur spécifiant le pourcentage de Duration de la chronologie consacré à la décélération du passage du temps de sa vitesse maximale à zéro.

(Hérité de Timeline)
DependencyObjectType

Obtient le DependencyObjectType qui encapsule le type CLR de cette instance.

(Hérité de DependencyObject)
Dispatcher

Obtient le Dispatcher associé à DispatcherObject.

(Hérité de DispatcherObject)
Duration

Obtient ou définit la durée de cette chronologie, sans prendre en compte les répétitions.

(Hérité de Timeline)
FillBehavior

Obtient ou définit une valeur qui spécifie comment Timeline se comporte quand il atteint la fin de sa période active.

(Hérité de Timeline)
HasAnimatedProperties

Obtient une valeur qui indique si un ou plusieurs objets AnimationClock sont associés à l'une ou l'autre des propriétés de dépendance de cet objet.

(Hérité de Animatable)
IsFrozen

Obtient une valeur qui indique si l’objet est actuellement modifiable.

(Hérité de Freezable)
IsSealed

Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule).

(Hérité de DependencyObject)
Name

Obtient ou définit le nom de ce Timeline.

(Hérité de Timeline)
RepeatBehavior

Obtient ou définit le comportement à répétition de cette chronologie.

(Hérité de Timeline)
SlipBehavior

Obtient ou définit une valeur qui spécifie le comportement de cette chronologie quand un ou plusieurs de ses enfants Timeline glissent.

(Hérité de ParallelTimeline)
SpeedRatio

Obtient ou définit le taux de progression temporelle par rapport à son parent de ce Timeline.

(Hérité de Timeline)

Propriétés attachées

Target

Obtient ou définit l'objet qui doit être animé.

TargetName

Obtient ou définit le nom de l’objet à animer. L’objet doit être un FrameworkElement, FrameworkContentElement ou Freezable.

TargetProperty

Chronologie de conteneur qui fournit des informations sur le ciblage des objets et des propriétés pour ses animations enfants.

Méthodes

AddChild(Object)

Ajoute un enfant Timeline à ce TimelineGroup.

(Hérité de TimelineGroup)
AddText(String)

Ajoute une chaîne de texte en tant qu’enfant de ce Timeline.

(Hérité de TimelineGroup)
AllocateClock()

Crée une horloge spécifique au type pour cette chronologie.

(Hérité de TimelineGroup)
ApplyAnimationClock(DependencyProperty, AnimationClock)

Applique AnimationClock au DependencyProperty spécifié. Si la propriété est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.

(Hérité de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Applique AnimationClock au DependencyProperty spécifié. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.

(Hérité de Animatable)
Begin()

Applique les animations associées à ce Storyboard à leurs cibles et les initialise.

Begin(FrameworkContentElement)

Applique les animations associées à ce Storyboard à leurs cibles et les initialise.

Begin(FrameworkContentElement, Boolean)

Applique les animations associées à ce Storyboard à leurs cibles et les initialise.

Begin(FrameworkContentElement, HandoffBehavior)

Applique les animations associées avec ce Storyboard à leurs cibles et les initialise à l'aide du HandoffBehavior spécifié.

Begin(FrameworkContentElement, HandoffBehavior, Boolean)

Applique les animations associées avec ce Storyboard à leurs cibles et les initialise à l'aide du HandoffBehavior spécifié.

Begin(FrameworkElement)

Applique les animations associées à ce Storyboard à leurs cibles et les initialise.

Begin(FrameworkElement, Boolean)

Applique les animations associées à ce Storyboard à leurs cibles et les initialise.

Begin(FrameworkElement, FrameworkTemplate)

Applique les animations associées avec ce Storyboard à leurs cibles dans le modèle spécifié et les initialise.

Begin(FrameworkElement, FrameworkTemplate, Boolean)

Applique les animations associées avec ce Storyboard à leurs cibles dans le modèle spécifié et les initialise.

Begin(FrameworkElement, FrameworkTemplate, HandoffBehavior)

Applique les animations associées avec ce Storyboard à leurs cibles dans le modèle spécifié et les initialise.

Begin(FrameworkElement, FrameworkTemplate, HandoffBehavior, Boolean)

Applique les animations associées avec ce Storyboard à leurs cibles dans le modèle spécifié et les initialise.

Begin(FrameworkElement, HandoffBehavior)

Applique les animations associées avec ce Storyboard à leurs cibles et les initialise à l'aide du HandoffBehavior spécifié.

Begin(FrameworkElement, HandoffBehavior, Boolean)

Applique les animations associées à ce Storyboard à leurs cibles et les initialise.

BeginAnimation(DependencyProperty, AnimationTimeline)

Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement de transfert SnapshotAndReplace est utilisé.

(Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Applique une animation au DependencyProperty spécifié. L’animation est démarrée lors de la restitution de l’image suivante. Si la propriété spécifiée est déjà animée, le comportement HandoffBehavior spécifié est utilisé.

(Hérité de Animatable)
CheckAccess()

Détermine si le thread appelant a accès à ce DispatcherObject.

(Hérité de DispatcherObject)
ClearValue(DependencyProperty)

Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un identificateur DependencyProperty.

(Hérité de DependencyObject)
ClearValue(DependencyPropertyKey)

Efface la valeur locale d’une propriété en lecture seule. La propriété à effacer est spécifiée par DependencyPropertyKey.

(Hérité de DependencyObject)
Clone()

Crée un clone modifiable de ce Storyboard, en créant des copies complètes des valeurs de cet objet. Pendant la copie des propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (qui risquent toutefois de ne plus pouvoir se résoudre), mais pas les animations ni leurs valeurs actuelles.

CloneCore(Freezable)

Fait de l’instance un clone (copie complète) du Freezable spécifié utilisant des valeurs de propriété (non animée) de base.

(Hérité de Freezable)
CloneCurrentValue()

Crée un clone modifiable de cet objet ParallelTimeline, en effectuant une copie complète des valeurs actuelles de cet objet. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.

(Hérité de ParallelTimeline)
CloneCurrentValueCore(Freezable)

Fait de l’instance un clone (copie complète) modifiable du Freezable spécifié à l’aide des valeurs de propriété actuelles.

(Hérité de Freezable)
CoerceValue(DependencyProperty)

Convertit la valeur de la propriété de dépendance spécifiée. Pour cela, on appelle toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur le DependencyObject appelant.

(Hérité de DependencyObject)
CreateClock()

Instancie un nouvel objet ClockGroup, à l'aide de cette instance.

(Hérité de TimelineGroup)
CreateClock(Boolean)

Crée un Clock à partir de ce Timeline et spécifie si le nouveau Clock est contrôlable. Si ce Timeline a des enfants, une arborescence d’horloges est créée avec ce Timeline comme racine.

(Hérité de Timeline)
CreateInstance()

Initialise une nouvelle instance de la classe Freezable.

(Hérité de Freezable)
CreateInstanceCore()

Crée une instance de la classe Storyboard.

Equals(Object)

Détermine si un DependencyObject fourni est équivalent au DependencyObject réel.

(Hérité de DependencyObject)
Freeze()

Rend l’objet actif non modifiable et attribue à sa propriété IsFrozen la valeur true.

(Hérité de Freezable)
FreezeCore(Boolean)

Rend cet objet Timeline non modifiable ou détermine s'il peut être rendu non modifiable.

(Hérité de Timeline)
GetAnimationBaseValue(DependencyProperty)

Retourne la valeur non animée de la propriété DependencyProperty spécifiée.

(Hérité de Animatable)
GetAsFrozen()

Crée une copie figée de Freezable, à l'aide des valeurs de propriété (non-animées) de base. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.

(Hérité de Freezable)
GetAsFrozenCore(Freezable)

Convertit cette instance en un clone de l’objet Timeline spécifié.

(Hérité de Timeline)
GetCurrentGlobalSpeed()

Récupère la CurrentGlobalSpeed du Clock créé pour ce Storyboard.

GetCurrentGlobalSpeed(FrameworkContentElement)

Récupère la CurrentGlobalSpeed du Clock créé pour ce Storyboard.

GetCurrentGlobalSpeed(FrameworkElement)

Récupère la CurrentGlobalSpeed du Clock créé pour ce Storyboard.

GetCurrentIteration()

Récupère la CurrentIteration du Clock créé pour ce Storyboard.

GetCurrentIteration(FrameworkContentElement)

Récupère la CurrentIteration du Clock créé pour ce Storyboard.

GetCurrentIteration(FrameworkElement)

Récupère la CurrentIteration du Clock créé pour ce Storyboard.

GetCurrentProgress()

Récupère la CurrentProgress du Clock créé pour ce Storyboard.

GetCurrentProgress(FrameworkContentElement)

Récupère la CurrentProgress du Clock créé pour ce Storyboard.

GetCurrentProgress(FrameworkElement)

Récupère la CurrentProgress du Clock créé pour ce Storyboard.

GetCurrentState()

Récupère la CurrentState du Clock créé pour ce Storyboard.

GetCurrentState(FrameworkContentElement)

Récupère la CurrentState du Clock créé pour ce Storyboard.

GetCurrentState(FrameworkElement)

Récupère la CurrentState du Clock créé pour ce Storyboard.

GetCurrentTime()

Récupère la CurrentTime du Clock créé pour ce Storyboard.

GetCurrentTime(FrameworkContentElement)

Récupère la CurrentTime du Clock créé pour ce Storyboard.

GetCurrentTime(FrameworkElement)

Récupère la CurrentTime du Clock créé pour ce Storyboard.

GetCurrentValueAsFrozen()

Crée une copie figée de Freezable à l'aide des valeurs de propriété actuelles. Étant donné que la copie est figée, tous les sous-objets figés sont copiés par référence.

(Hérité de Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Convertit cette instance en clone figé du Timeline spécifié. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.

(Hérité de Timeline)
GetHashCode()

Obtient un code de hachage pour ce DependencyObject.

(Hérité de DependencyObject)
GetIsPaused()

Récupère une valeur qui indique si Clock qui a été créé pour Storyboard est suspendu.

GetIsPaused(FrameworkContentElement)

Récupère une valeur qui indique si Clock qui a été créé pour Storyboard est suspendu.

GetIsPaused(FrameworkElement)

Récupère une valeur qui indique si Clock qui a été créé pour Storyboard est suspendu.

GetLocalValueEnumerator()

Crée un énumérateur spécialisé pour déterminer quelles propriétés de dépendance ont des valeurs définies localement sur ce DependencyObject.

(Hérité de DependencyObject)
GetNaturalDuration(Clock)

Retourne la durée d'une seule itération de ce Timeline.

(Hérité de Timeline)
GetNaturalDurationCore(Clock)

Retourne la durée naturelle (durée d'une itération unique) à partir d'un Clock spécifié.

(Hérité de ParallelTimeline)
GetTarget(DependencyObject)

Récupère la valeur Target du Timeline spécifié.

GetTargetName(DependencyObject)

Récupère la valeur TargetName du Timeline spécifié.

GetTargetProperty(DependencyObject)

Récupère la valeur TargetProperty du Timeline spécifié.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetValue(DependencyProperty)

Retourne la valeur effective actuelle d’une propriété de dépendance sur cette instance d’un DependencyObject.

(Hérité de DependencyObject)
InvalidateProperty(DependencyProperty)

Réévalue la valeur effective de la propriété de dépendance spécifiée.

(Hérité de DependencyObject)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
OnChanged()

Appelé lorsque l’objet Freezable actuel est modifié.

(Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Garantit que les pointeurs de contexte appropriés sont établis pour un membre de données de type DependencyObjectType qui vient juste d'être défini.

(Hérité de Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Ce membre prend en charge l’infrastructure Windows Presentation Foundation (WPF) et n’est pas destiné à être utilisé directement à partir de votre code.

(Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Substitue l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) pour appeler également tous les gestionnaires Changed en réponse à une propriété de dépendance variable de type Freezable.

(Hérité de Freezable)
Pause()

Suspend Clock qui a été créé pour Storyboard.

Pause(FrameworkContentElement)

Suspend le Clock du FrameworkContentElement spécifié associé à ce Storyboard.

Pause(FrameworkElement)

Suspend le Clock du FrameworkElement spécifié associé à ce Storyboard.

ReadLocalValue(DependencyProperty)

Retourne la valeur locale d’une propriété de dépendance, si elle existe.

(Hérité de DependencyObject)
ReadPreamble()

Garantit que Freezable est accessible à partir d'un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API lisant les membres de données qui ne sont pas des propriétés de dépendance.

(Hérité de Freezable)
Remove()

Supprime les objets Clock qui ont été créés pour ce Storyboard. Les animations qui appartiennent à ce Storyboard n’affectent plus les propriétés qu’elles animaient auparavant, quel que soit leur paramètre FillBehavior.

Remove(FrameworkContentElement)

Supprime les objets Clock qui ont été créés pour ce Storyboard. Les animations qui appartiennent à ce Storyboard n’affectent plus les propriétés qu’elles animaient auparavant, quel que soit leur paramètre FillBehavior.

Remove(FrameworkElement)

Supprime les objets Clock qui ont été créés pour ce Storyboard. Les animations qui appartiennent à ce Storyboard n’affectent plus les propriétés qu’elles animaient auparavant, quel que soit leur paramètre FillBehavior.

Resume()

Reprend le Clock qui a été créé pour ce Storyboard.

Resume(FrameworkContentElement)

Reprend le Clock qui a été créé pour ce Storyboard.

Resume(FrameworkElement)

Reprend le Clock qui a été créé pour ce Storyboard.

Seek(FrameworkContentElement, TimeSpan, TimeSeekOrigin)

Recherche ce Storyboard à la position spécifiée. Storyboard exécute la recherche demandée lors du battement d’horloge suivant.

Seek(FrameworkElement, TimeSpan, TimeSeekOrigin)

Recherche ce Storyboard à la position spécifiée. Storyboard exécute la recherche demandée lors du battement d’horloge suivant.

Seek(TimeSpan)

Recherche ce Storyboard à la position spécifiée. Storyboard exécute la recherche demandée lors du battement d’horloge suivant.

Seek(TimeSpan, TimeSeekOrigin)

Recherche ce Storyboard à la position spécifiée. Storyboard exécute la recherche demandée lors du battement d’horloge suivant.

SeekAlignedToLastTick(FrameworkContentElement, TimeSpan, TimeSeekOrigin)

Recherche immédiatement Storyboard à une nouvelle position (de façon synchrone).

SeekAlignedToLastTick(FrameworkElement, TimeSpan, TimeSeekOrigin)

Recherche immédiatement Storyboard à une nouvelle position (de façon synchrone).

SeekAlignedToLastTick(TimeSpan)

Recherche immédiatement Storyboard à une nouvelle position (de façon synchrone).

SeekAlignedToLastTick(TimeSpan, TimeSeekOrigin)

Recherche immédiatement Storyboard à une nouvelle position (de façon synchrone).

SetCurrentValue(DependencyProperty, Object)

Définit la valeur d’une propriété de dépendance sans modifier sa valeur source.

(Hérité de DependencyObject)
SetSpeedRatio(Double)

Définit le quotient de vitesse interactif pour le Clock qui a été créé pour ce Storyboard.

SetSpeedRatio(FrameworkContentElement, Double)

Définit le quotient de vitesse interactif du Clock qui a été créé pour ce Storyboard.

SetSpeedRatio(FrameworkElement, Double)

Définit le quotient de vitesse interactif du Clock qui a été créé pour ce Storyboard.

SetTarget(DependencyObject, DependencyObject)

Permet que le Timeline spécifié cible l'objet de dépendance.

SetTargetName(DependencyObject, String)

Fait de la cible Timeline spécifiée la propriété de dépendance avec le nom spécifié.

SetTargetProperty(DependencyObject, PropertyPath)

Fait de la cible Timeline spécifiée la propriété de dépendance spécifiée.

SetValue(DependencyProperty, Object)

Définit la valeur locale d’une propriété de dépendance, spécifiée par son identificateur de propriété de dépendance.

(Hérité de DependencyObject)
SetValue(DependencyPropertyKey, Object)

Définit la valeur locale d’une propriété de dépendance en lecture seule, spécifiée par l’identificateur DependencyPropertyKey de la propriété de dépendance.

(Hérité de DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur de la propriété de dépendance fournie.

(Hérité de DependencyObject)
SkipToFill()

Avance l’heure actuelle du Clock de ce plan conceptuel à la fin de sa période active.

SkipToFill(FrameworkContentElement)

Avance l’heure actuelle du Clock de ce plan conceptuel à la fin de sa période active.

SkipToFill(FrameworkElement)

Avance l’heure actuelle du Clock de ce plan conceptuel à la fin de sa période active.

Stop()

Arrête le Clock qui a été créé pour ce Storyboard.

Stop(FrameworkContentElement)

Arrête le Clock qui a été créé pour ce Storyboard.

Stop(FrameworkElement)

Arrête le Clock qui a été créé pour ce Storyboard.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
VerifyAccess()

Garantit que le thread appelant a accès à DispatcherObject.

(Hérité de DispatcherObject)
WritePostscript()

Déclenche l’événement Changed pour le Freezable et appelle sa méthode OnChanged(). Les classes qui dérivent de Freezable doivent appeler cette méthode à la fin de toute API qui modifie des membres de classe qui ne sont pas stockés en tant que propriétés de dépendance.

(Hérité de Freezable)
WritePreamble()

Vérifie que le Freezable n'est pas figé et que son accès s'effectue à partir d'un contexte de thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API écrivant dans les membres de données qui ne sont pas des propriétés de dépendance.

(Hérité de Freezable)

Événements

Changed

Se produit lorsque Freezable ou un objet qu'il contient est modifié.

(Hérité de Freezable)
Completed

Se produit lorsque cette chronologie est complètement terminée et n'entrera plus dans sa période active.

(Hérité de Timeline)
CurrentGlobalSpeedInvalidated

Se produit lorsque le taux auquel l'heure progresse pour l'horloge de la chronologie change.

(Hérité de Timeline)
CurrentStateInvalidated

Se produit quand la propriété CurrentState de Clock de la chronologie est mise à jour.

(Hérité de Timeline)
CurrentTimeInvalidated

Se produit quand la propriété CurrentTime de Clock de la chronologie est mise à jour.

(Hérité de Timeline)
RemoveRequested

Se produit lorsque l'horloge créée pour cette chronologie ou une de ses chronologies parentes est supprimée.

(Hérité de Timeline)

Implémentations d’interfaces explicites

IAddChild.AddChild(Object)

Ajoute un objet enfant.

(Hérité de TimelineGroup)
IAddChild.AddText(String)

Ajoute le contenu textuel d’un nœud à l’objet.

(Hérité de TimelineGroup)

S’applique à