Timeline Classe

Définition

Espace de noms:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Définit un segment de temps.

public ref class Timeline abstract : System::Windows::Media::Animation::Animatable

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public abstract class Timeline : System.Windows.Media.Animation.Animatable

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type Timeline = class
    inherit Animatable

Public MustInherit Class Timeline
Inherits Animatable

Héritage

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

Dérivé

System.Windows.Media.Animation.AnimationTimeline

System.Windows.Media.Animation.TimelineGroup

System.Windows.Media.MediaTimeline

Attributs

LocalizabilityAttribute RuntimeNamePropertyAttribute

Remarques

Une chronologie représente un segment de temps. Elle fournit des propriétés qui vous permettent de spécifier la longueur de ce segment, le moment où il doit démarrer, combien de fois il doit se répéter, à quelle vitesse le temps s’écoule dans ce segment et bien plus encore.

Les classes qui héritent de la classe de chronologie fournissent des fonctionnalités supplémentaires, comme la lecture de médias et d’animations. Voici des exemples de certains des différents types de chronologies spécialisées disponibles.

• Animations : un AnimationTimeline est un type de chronologie qui produit des valeurs de sortie. Lorsque vous associez une animation à une propriété, l’animation met à jour la valeur de la propriété au fur et à mesure qu’elle est lue, la « animant ». Pour une présentation des animations, consultez Vue d’ensemble des animations. Pour plus d’informations sur les différentes façons d’appliquer des animations, consultez Vue d’ensemble des techniques d’animation de propriétés.

• MediaTimelines : un MediaTimeline type de chronologie qui contrôle la lecture d’un fichier multimédia.

• ParallelTimelines : un ParallelTimeline type de chronologie qui regroupe d’autres chronologies.

• Storyboards : un Storyboard type spécial de qui fournit des informations de ciblage d’objet et de ParallelTimeline propriété pour les chronologies qu’il contient. Pour plus d’informations sur Storyboard les objets, consultez vue d’ensemble des storyboards.

Pour plus d’informations sur l’utilisation des chronologies, consultez vue d’ensemble de l’animation. Pour une présentation des fonctionnalités de minutage des chronologies, consultez vue d’ensemble des comportements de minutage.

Liaison de données et animation de chronologies

La plupart des propriétés de 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’une chronologie.

Lorsqu’une chronologie est appliquée, des copies sont effectuées de la 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. Ce sont ces horloges qui effectuent le travail réel d’animation des propriétés ciblées. Si une chronologie était liée aux données ou animée, un instantané de ses valeurs actuelles a été créé lors de la création de son horloge. Même si la 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 régénérée. Les horloges ne sont pas régénérées automatiquement pour vous. Voici plusieurs façons d’appliquer des modifications de chronologie :

• Si la chronologie est ou appartient à un Storyboard, vous pouvez lui faire refléter les modifications en réappliquer son storyboard à l’aide d’une BeginStoryboard ou de la Begin méthode . Cela a pour effet secondaire de redémarrer également l’animation. Dans le code, vous pouvez utiliser la Seek méthode pour faire avancer 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-le pour remplacer le précédent jeu d’horloges généré.

Pour obtenir un exemple d’animation liée aux données, consultez l’exemple d’animation spline clé .

Utilisation d’une chronologie comme minuteur

L’horloge d’une chronologie ne progresse que lorsqu’un gestionnaire d’événements lui est associé ou (dans le cas d’un AnimationClock objet) qu’il est associé à une propriété. Pour cette raison (et d’autres), il n’est pas recommandé d’utiliser un Timeline comme minuteur.

Constructeurs

Timeline()	Initialise une nouvelle instance de la classe Timeline.
Timeline(Nullable<TimeSpan>)	Initialise une nouvelle instance de la classe Timeline avec le BeginTime spécifié.
Timeline(Nullable<TimeSpan>, Duration)	Initialise une nouvelle instance de la classe Timeline avec les BeginTime et Duration spécifiés.
Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior)	Initialise une nouvelle instance de la classe Timeline avec les BeginTime, Duration et RepeatBehavior spécifiés.

Champs

AccelerationRatioProperty	Identifie la propriété de dépendance AccelerationRatio.
AutoReverseProperty	Identifie la propriété de dépendance AutoReverse.
BeginTimeProperty	Identifie la propriété de dépendance BeginTime.
DecelerationRatioProperty	Identifie la propriété de dépendance DecelerationRatio.
DesiredFrameRateProperty	Identifie la propriété jointe DesiredFrameRate.
DurationProperty	Identifie la propriété de dépendance Duration.
FillBehaviorProperty	Identifie la propriété de dépendance FillBehavior.
NameProperty	Identifie la propriété de dépendance Name.
RepeatBehaviorProperty	Identifie la propriété de dépendance RepeatBehavior.
SpeedRatioProperty	Identifie la propriété de dépendance SpeedRatio.

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.
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.
BeginTime	Obtient ou définit l’heure à laquelle ce Timeline doit commencer.
CanFreeze	Obtient une valeur qui indique si l’objet peut être rendu non modifiable. (Hérité de Freezable)
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.
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.
FillBehavior	Obtient ou définit une valeur qui spécifie comment Timeline se comporte quand il atteint la fin de sa période active.
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.
RepeatBehavior	Obtient ou définit le comportement à répétition de cette chronologie.
SpeedRatio	Obtient ou définit le taux de progression temporelle par rapport à son parent de ce Timeline.

Propriétés attachées

DesiredFrameRate

Obtient ou définit la fréquence d'images souhaitée pour cette chronologie et ses chronologies enfants.

Méthodes

AllocateClock()	Crée un Clock pour ce Timeline.
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)
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 Timeline, en créant des copies complètes des valeurs de cet objet.
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 Timeline, en effectuant une copie complète des valeurs actuelles de cet objet.
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()	Crée un Clock contrôlable à partir de ce Timeline. Si ce Timeline a des enfants, une arborescence d’horloges est créée avec ce Timeline comme racine.
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.
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	Une fois implémentée dans une classe dérivée, initialise une nouvelle instance de la classe dérivée Freezable. (Hérité de Freezable)
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.
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é.
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.
GetDesiredFrameRate(Timeline)	Obtient la fréquence d'images souhaitée du Timeline spécifié.
GetHashCode()	Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject)
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.
GetNaturalDurationCore(Clock)	Retourne la durée d'une seule itération de ce Timeline. Cette méthode assure l'implémentation de GetNaturalDuration(Clock).
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 WPF (Windows Presentation Foundation) 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)
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)
SetCurrentValue(DependencyProperty, Object)	Définit la valeur d’une propriété de dépendance sans modifier sa valeur source. (Hérité de DependencyObject)
SetDesiredFrameRate(Timeline, Nullable<Int32>)	Définit la fréquence d'images souhaitée du Timeline spécifié.
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)
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.
CurrentGlobalSpeedInvalidated	Se produit lorsque le taux auquel l'heure progresse pour l'horloge de la chronologie change.
CurrentStateInvalidated	Se produit quand la propriété CurrentState de Clock de la chronologie est mise à jour.
CurrentTimeInvalidated	Se produit quand la propriété CurrentTime de Clock de la chronologie est mise à jour.
RemoveRequested	Se produit lorsque l'horloge créée pour cette chronologie ou une de ses chronologies parentes est supprimée.

Voir aussi

• Comportement de minuterie d’animation exemple