Timeline Classe

  • Référence

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é
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.

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.

S’applique à

Voir aussi