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. Il fournit des propriétés qui vous permettent de spécifier la longueur de ce segment, le moment où il doit démarrer, le nombre de fois qu’il se répète, le temps de progression rapide dans ce segment, et bien plus encore.

Les classes qui héritent de la classe de chronologie fournissent des fonctionnalités supplémentaires, telles que l’animation et la lecture multimédia. Voici quelques-uns des différents types de chronologies spécialisées disponibles.

• Animations : il AnimationTimeline s’agit d’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, ce qui l’anime. Pour une présentation des animations, consultez Vue d’ensemble de l’animation. Pour plus d’informations sur les différentes façons d’appliquer des animations, consultez la vue d’ensemble des techniques d’animation de propriété.

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

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

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

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

Liaison de données et animation des 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 permet de comprendre ce qu’il signifie pour activer une chronologie.

Lorsqu’une chronologie est appliquée, des copies sont effectuées dans la chronologie et dans ses chronologies enfants. Ces copies sont figées (en lecture seule) et Clock les objets sont créés à partir d’eux. C’est 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é effectué 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. Voici plusieurs façons d’appliquer des modifications de chronologie :

• Si la chronologie appartient à un Storyboard, vous pouvez refléter les changements en réappliquant son storyboard à l’aide d’une BeginStoryboard ou de la méthode Begin. Cela a l’effet secondaire du redémarrage de l’animation. Dans le code, vous pouvez utiliser la Seek méthode pour ramener 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-la à l’animation qui a été modifiée.

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

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

Utilisation d’une chronologie en tant que minuteur

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

Constructeurs

Nom	Description
Timeline()	Initialise une nouvelle instance de la classe Timeline.
Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior)	Initialise une nouvelle instance de la Timeline classe avec le BeginTime, Durationet RepeatBehavior.
Timeline(Nullable<TimeSpan>, Duration)	Initialise une nouvelle instance de la Timeline classe avec les données spécifiées BeginTime et Duration.
Timeline(Nullable<TimeSpan>)	Initialise une nouvelle instance de la Timeline classe avec le fichier spécifié BeginTime.

Champs

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

Propriétés

Nom	Description
AccelerationRatio	Obtient ou définit une valeur spécifiant le pourcentage de la chronologie Duration passée à accélérer le passage du temps de zéro à son taux maximal.
AutoReverse	Obtient ou définit une valeur qui indique si la chronologie est lue à l’inverse une fois qu’elle a terminé une itération vers l’avant.
BeginTime	Obtient ou définit l’heure à laquelle cela 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 décélération du temps passé de la chronologie Duration de son taux maximal à zéro.
DependencyObjectType	Obtient le DependencyObjectType type CLR de cette instance. (Hérité de DependencyObject)
Dispatcher	Obtient ce Dispatcher qui DispatcherObject est associé. (Hérité de DispatcherObject)
Duration	Obtient ou définit la durée pendant laquelle cette chronologie joue, sans compter les répétitions.
FillBehavior	Obtient ou définit une valeur qui spécifie le Timeline comportement après qu’il atteint la fin de sa période active.
HasAnimatedProperties	Obtient une valeur qui indique si un ou plusieurs AnimationClock objets sont associés à l’une 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	Obtient une valeur qui indique si cette instance est actuellement scellée (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étitif de cette chronologie.
SpeedRatio	Obtient ou définit le taux, par rapport à son parent, au moment où il progresse pour cela Timeline.

Propriétés attachées

Nom	Description
DesiredFrameRate	Obtient ou définit la fréquence d’images souhaitée pour cette chronologie et ses chronologies enfants.

Méthodes

Nom	Description
AllocateClock()	Crée un Clock pour cela Timeline.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, la propriété HandoffBehavior spécifiée est utilisée. (Hérité de Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Applique un AnimationClock à l’objet spécifié DependencyProperty. Si la propriété est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, celle-ci HandoffBehavior est utilisée. (Hérité de Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Applique une animation au fichier spécifié DependencyProperty. L’animation est démarrée lorsque l’image suivante est rendue. Si la propriété spécifiée est déjà animée, le comportement de SnapshotAndReplace transfert est utilisé. (Hérité de Animatable)
CheckAccess()	Détermine si le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
ClearValue(DependencyProperty)	Efface la valeur locale d’une propriété. La propriété à effacer est spécifiée par un DependencyProperty identificateur. (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 un DependencyPropertyKey. (Hérité de DependencyObject)
Clone()	Crée un clone modifiable de ce Timelinefichier, en effectuant des copies approfondies des valeurs de cet objet.
CloneCore(Freezable)	Rend l’instance un clone (copie approfondie) de la propriété de base (non animée) spécifiée Freezable . (Hérité de Freezable)
CloneCurrentValue()	Crée un clone modifiable de cet Timeline objet, effectuant des copies approfondies des valeurs actuelles de cet objet.
CloneCurrentValueCore(Freezable)	Rend l’instance un clone modifiable (copie approfondie) de l’élément spécifié Freezable à l’aide de valeurs de propriété actuelles. (Hérité de Freezable)
CoerceValue(DependencyProperty)	Force la valeur de la propriété de dépendance spécifiée. Pour ce faire, appelez n’importe quelle CoerceValueCallback fonction spécifiée dans les métadonnées de propriété pour la propriété de dépendance telle qu’elle existe sur l’appel DependencyObject. (Hérité de DependencyObject)
CreateClock()	Crée un élément contrôlable Clock à partir de ce Timeline. Si cela Timeline a des enfants, une arborescence d’horloges est créée avec celle-ci Timeline comme racine.
CreateClock(Boolean)	Crée un nouveau Clock à partir de ceci Timeline et spécifie si le nouveau Clock est contrôlable. Si cela Timeline a des enfants, une arborescence d’horloges est créée avec celle-ci Timeline comme racine.
CreateInstance()	Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable)
CreateInstanceCore()	En cas d’implémentation dans une classe dérivée, crée une nouvelle instance de la Freezable classe dérivée. (Hérité de Freezable)
Equals(Object)	Détermine si un élément fourni DependencyObject est équivalent à l’actuel DependencyObject. (Hérité de DependencyObject)
Freeze()	Rend l’objet actuel non modifiable et définit sa IsFrozen propriété sur true. (Hérité de Freezable)
FreezeCore(Boolean)	Rend cela Timeline non modifiable ou détermine s’il peut être rendu inmodifiable.
GetAnimationBaseValue(DependencyProperty)	Retourne la valeur non animée de l’objet spécifié DependencyProperty. (Hérité de Animatable)
GetAsFrozen()	Crée une copie figée des valeurs de Freezablepropriété de base (non animées). É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)	Fait de cette instance un clone de l’objet spécifié Timeline .
GetCurrentValueAsFrozen()	Crée une copie figée de l’utilisation Freezable 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)	Fait de cette instance un clone figé du fichier spécifié Timeline. Les références de ressources, les liaisons de données et les animations ne sont pas copiées, mais leurs valeurs actuelles sont.
GetDesiredFrameRate(Timeline)	Obtient la fréquence d’images souhaitée de l’image spécifiée Timeline.
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 longueur d’une seule itération de ce Timeline.
GetNaturalDurationCore(Clock)	Retourne la longueur d’une seule itération de ce Timeline. Cette méthode fournit l’implémentation pour GetNaturalDuration(Clock).
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)	Évalue à nouveau la valeur effective de la propriété de dépendance spécifiée. (Hérité de DependencyObject)
OnChanged()	Appelé lorsque l’objet actuel Freezable est modifié. (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)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Garantit que les pointeurs de contexte appropriés sont établis pour un DependencyObjectType membre de données qui vient d’être défini. (Hérité de Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Remplace l’implémentation DependencyObject de OnPropertyChanged(DependencyPropertyChangedEventArgs) l’appel de tous Changed les gestionnaires en réponse à une propriété de dépendance modifiée de type Freezable. (Hérité de Freezable)
ReadLocalValue(DependencyProperty)	Retourne la valeur locale d’une propriété de dépendance, le cas échéant. (Hérité de DependencyObject)
ReadPreamble()	Garantit l’accès Freezable à partir d’un thread valide. Les héritiers de Freezable doivent appeler cette méthode au début de toute API qui lit 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 source de valeur. (Hérité de DependencyObject)
SetDesiredFrameRate(Timeline, Nullable<Int32>)	Définit la fréquence d’images souhaitée de l’image spécifiée Timeline.
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)
VerifyAccess()	Applique que le thread appelant a accès à ce DispatcherObjectfichier . (Hérité de DispatcherObject)
WritePostscript()	Déclenche l’événement Changed pour la Freezable méthode et appelle sa OnChanged() méthode. Les classes dérivées Freezable de doivent appeler cette méthode à la fin de toute API qui modifie les 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 l’objet Freezable n’est pas figé et qu’il est accessible à partir d’un contexte de threading valide. Freezable Les hériteurs doivent appeler cette méthode au début de toute API qui écrit dans les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable)

Événements

Nom	Description
Changed	Se produit lorsque l’objet Freezable qu’il contient est modifié. (Hérité de Freezable)
Completed	Se produit lorsque cette chronologie a complètement terminé la lecture : elle n’entre plus dans sa période active.
CurrentGlobalSpeedInvalidated	Se produit lorsque la vitesse à laquelle progresse l’horloge de la chronologie change.
CurrentStateInvalidated	Se produit lorsque la CurrentState propriété de la chronologie Clock est mise à jour.
CurrentTimeInvalidated	Se produit lorsque la CurrentTime propriété de la chronologie Clock est mise à jour.
RemoveRequested	Se produit lorsque l’horloge créée pour cette chronologie ou l’une de ses chronologies parentes est supprimée.

Voir aussi

• Exemple de comportement de minutage d’animation