Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.

Traduction

Source

Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Timeline, classe

.NET Framework 4

Autres versions

Définit un segment de temps.

Hiérarchie d'héritage

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        System.Windows.Media.Animation.Animatable
          System.Windows.Media.Animation.Timeline
            System.Windows.Media.Animation.AnimationTimeline
            System.Windows.Media.Animation.TimelineGroup
            System.Windows.Media.MediaTimeline

Espace de noms : System.Windows.Media.Animation
Assembly : PresentationCore (dans PresentationCore.dll)

Syntaxe

C++

Copier

[RuntimeNamePropertyAttribute("Name")]
[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
public abstract class Timeline : Animatable

Le type Timeline expose les membres suivants.

Constructeurs

	Nom	Description
	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.

Début

Propriétés

	Nom	Description
	AccelerationRatio	Obtient ou définit une valeur spécifiant le pourcentage du Duration de la chronologie nécessaire à l'accélération temporelle pour passer de zéro à son taux maximal.
	AutoReverse	Obtient ou définit une valeur qui indique si la chronologie repart en arrière après avoir accompli une itération en avant.
	BeginTime	Obtient ou établit l'heure à laquelle ce Timeline doit commencer.
	CanFreeze	Obtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.)
	DecelerationRatio	Obtient ou définit une valeur spécifiant le pourcentage du Duration de la chronologie nécessaire à la décélération temporelle pour passer de son taux maximal à 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 les répétitions.
	FillBehavior	Obtient ou définit une valeur qui spécifie le comportement du Timeline une fois qu'il a 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 ou pas. (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.

Début

Propriétés jointes

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

Début

Méthodes

	Nom	Description
	AllocateClock	Crée un Clock pour ce Timeline.
	ApplyAnimationClock(DependencyProperty, AnimationClock)	Applique une horloge AnimationClock à la propriété DependencyProperty spécifiée. 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 une horloge AnimationClock à la propriété DependencyProperty spécifiée. 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 à la propriété DependencyPropertyspécifiée. L'animation est démarrée à 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 à la propriété DependencyPropertyspécifiée. L'animation est démarrée à 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 de proximité 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 de proximité 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 Timeline, en copiant intégralement toutes les valeurs de cet objet.
	CloneCore	Convertit l'instance en clone (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés (non-animées) de base. (Hérité de Freezable.)
	CloneCurrentValue	Crée un clone modifiable de cet objet Timeline, en créant des copies complètes des valeurs actuelles de cet objet.
	CloneCurrentValueCore	Convertit l'instance en clone modifiable (copie complète) du Freezable spécifié à l'aide des valeurs de propriétés actuelles. (Hérité de Freezable.)
	CoerceValue	Force la valeur de la propriété de dépendance spécifiée. Cette opération est accomplie en appelant toute fonction CoerceValueCallback spécifiée dans les métadonnées de propriété pour la propriété de dépendance comme elle existe sur le DependencyObject appelant. (Hérité de DependencyObject.)
	CreateClock()	Crée un nouveau Clock contrôlable à partir de ce Timeline. Si ce Timeline a des enfants, une arborescence d'horloges est alors créée avec ce Timeline en tant que 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 alors créée avec ce Timeline en tant que 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	Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
	Finalize	Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
	Freeze()	Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.)
	FreezeCore	Rend cet objet Timeline non modifiable ou détermine s'il peut être rendu non modifiable. (Substitue Animatable.FreezeCore(Boolean).)
	GetAnimationBaseValue	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	Convertit cette instance en clone de l'objet Timeline spécifié. (Substitue Freezable.GetAsFrozenCore(Freezable).)
	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	Convertit cette instance en clone figé du Timeline spécifié. Contrairement aux valeurs actuelles, les références de ressource, les liaisons de données et les animations ne sont pas copiées. (Substitue Freezable.GetCurrentValueAsFrozenCore(Freezable).)
	GetDesiredFrameRate	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	Retourne la durée d'une seule itération de ce Timeline.
	GetNaturalDurationCore	Retourne la durée d'une seule itération de ce Timeline. Cette méthode assure l'implémentation de GetNaturalDuration.
	GetType	Obtient le Type de l'instance actuelle. (Hérité de Object.)
	GetValue	Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
	InvalidateProperty	Réévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
	MemberwiseClone	Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
	OnChanged	Appelé lors de la modification de l'objet Freezable actuel. (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 conçu pour être utilisé directement à partir du code. (Hérité de Freezable.)
	OnPropertyChanged	Substitue l'implémentation DependencyObject de OnPropertyChanged 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	Retourne la valeur de proximité 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	Définit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
	SetDesiredFrameRate	Définit la fréquence d'images souhaitée du Timeline spécifié.
	SetValue(DependencyProperty, Object)	Définit la valeur de proximité 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 de proximité 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	Retourne une valeur qui indique si les processus de sérialisation doivent sérialiser la valeur pour 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 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 non 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 les membres de données qui ne sont pas des propriétés de dépendance. (Hérité de Freezable.)

Début

Événements

	Nom	Description
	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 lorsque la propriété CurrentState du Clock de la chronologie est mise à jour.
	CurrentTimeInvalidated	Se produit lorsque la propriété CurrentTime du 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.

Début

Champs

	Nom	Description
	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.

Début

Notes

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, lorsqu'il doit démarrer, combien de fois il se répétera, à quelle vitesse progresse le temps dans ce segment, etc.

Les classes qui héritent de la classe de chronologie proposent d'autres fonctionnalités, telles que la lecture de médias et d'animations. Différents types de chronologies spécialisées parmi ceux disponibles sont donnés en exemple ci-dessous.

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é lors de sa lecture, contribuant ainsi à « l'animer ». Pour une présentation des animations, consultez Vue d'ensemble de l'animation. Pour plus d'informations sur les différentes méthodes d'application d'animations, consultez Vue d'ensemble des techniques d'animation de propriétés.
MediaTimelines : un MediaTimeline est un type de chronologie qui contrôle la lecture d'un fichier multimédia.
ParallelTimelines : un ParallelTimeline est un type de chronologie qui regroupe d'autres chronologies.
Storyboards : un Storyboard est un type spécial de ParallelTimeline qui propose des informations de ciblage sur les objets et les propriétés destinées aux chronologies qu'il contient. Pour plus d'informations sur les objets Storyboard, consultez Vue d'ensemble des storyboards.

Pour plus d'informations sur l'utilisation des chronologies, consultez Vue d'ensemble de l'animation. Pour obtenir une introduction aux fonctionnalités de minutage des chronologies, consultez 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, à cause de la façon dont le système de minuterie fonctionne, 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 nécessaire de comprendre ce que cela signifie d'activer une chronologie.

Lorsqu'une chronologie est appliquée, les copies sont constituées de la chronologie et de ses chronologies enfants. Ces copies sont figées (en lecture seule) et les objets Clock sont créés depuis celles-ci. Ce sont ces horloges qui assurent dans la réalité l'animation des propriétés ciblées. Lorsqu'une chronologie est liée aux données ou animée, une capture instantanée de ses valeurs actuelles est effectuée lors de la création de son horloge. Bien que la chronologie d'origine puisse continuer à changer, son horloge ne change pas.

Pour qu'une chronologie reflète les modifications d'une liaison de données ou d'une 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 est ou appartient à un Storyboard, vous pouvez alors faire en sorte qu'elle reflète les modifications, en réappliquant sa table de montage séquentiel à l'aide d'un BeginStoryboard ou de la méthode Begin. Cela redémarre par contre également l'animation. Dans le code, vous pouvez utiliser la méthode Seek pour replacer la table de montage séquentiel à sa position précédente.
Si vous avez directement appliqué une animation à une propriété à l'aide de la méthode BeginAnimation, rappelez la méthode BeginAnimation et passez-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 le précédent jeu d'horloges générées.

Pour obtenir un exemple d'une animation liée aux données, consultez Animation de spline clé, exemple.

Utilisation d'une chronologie en tant que minuterie

L'horloge d'une chronologie progresse uniquement lorsqu'un gestionnaire d'événements y est associé ou lorsqu'elle est associée à une propriété (dans le cas d'un objet AnimationClock). Pour cette raison notamment, il n'est pas recommandé d'utiliser un Timeline en tant que minuterie.

Informations de version

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Plateformes

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

System.Windows.Media.Animation, espace de noms

Autres ressources

Vue d'ensemble de l'animation

Vue d'ensemble des storyboards

Vue d'ensemble des événements de minutage

Vue d'ensemble des comportements de minutage

Comportement de minutage d'une animation, exemple

Cela vous a-t-il été utile ? Oui Non

Manque de précision

Pas suffisamment approfondi

Besoin d'exemples de code supplémentaires

La traduction a besoin d'être améliorée.

(1500 caractères restants)

Contenu de la communauté Ajouter

FAQ