ByteAnimation Classe

Définition

Espace de noms:

System.Windows.Media.Animation

Assembly:

PresentationCore.dll

Anime la valeur d’une propriété Byte entre deux valeurs cibles à l’aide d’une interpolation linéaire sur un Duration spécifié.

public ref class ByteAnimation : System::Windows::Media::Animation::ByteAnimationBase

public class ByteAnimation : System.Windows.Media.Animation.ByteAnimationBase

type ByteAnimation = class
    inherit ByteAnimationBase

Public Class ByteAnimation
Inherits ByteAnimationBase

Héritage

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

AnimationTimeline

ByteAnimationBase

ByteAnimation

Remarques

Une animation met à jour la valeur d’une propriété sur une période donnée. Un effet d’animation peut être subtil, comme déplacer Shape quelques pixels vers la gauche et la droite, ou dramatique, comme agrandir un objet à 200 fois sa taille d’origine tout en le faisant tourner et en modifiant sa couleur. Pour créer une animation dans Windows Presentation Foundation (WPF), vous associez une animation à la valeur de propriété d’un objet.

Valeurs cibles

La ByteAnimation classe crée une transition entre deux valeurs cibles. Pour définir ses valeurs cibles, utilisez ses Frompropriétés , Toet By . Le tableau suivant résume la façon dont les Frompropriétés , Toet By peuvent être utilisées ensemble ou séparément pour déterminer les valeurs cibles d’une animation.

Propriétés spécifiées	Comportement résultant
From	L’animation progresse de la valeur spécifiée par la From propriété à la valeur de base de la propriété animée ou à la valeur de sortie d’une animation précédente, selon la façon dont l’animation précédente est configurée.
From et To	L’animation progresse de la valeur spécifiée par la From propriété à la valeur spécifiée par la To propriété .
From et By	L’animation progresse de la valeur spécifiée par la From propriété à la valeur spécifiée par la somme des From propriétés et By .
To	L’animation progresse de la valeur de base de la propriété animée ou de la valeur de sortie d’une animation précédente à la valeur spécifiée par la To propriété .
By	L’animation progresse à partir de la valeur de base de la propriété animée ou de la valeur de sortie d’une animation précédente à la somme de cette valeur et de la valeur spécifiée par la By propriété .

Notes

Si vous définissez à la fois les To propriétés et By , la To propriété est prioritaire et la By propriété est ignorée.

Pour utiliser d’autres méthodes d’interpolation ou animer entre plus de deux valeurs cibles, utilisez un ByteAnimationUsingKeyFrames objet .

Pour plus d’informations sur l’application de plusieurs animations à une seule propriété, consultez Vue d’ensemble des animations d’images clés.

Fonctionnalités Freezable

Étant donné que la ByteAnimation classe hérite de Freezable, ByteAnimation les objets bénéficient de plusieurs fonctionnalités spéciales, notamment : ils peuvent être déclarés en tant que ressources, partagés entre plusieurs objets, en lecture seule pour améliorer les performances, cloné et rendus thread-safe. Pour plus d’informations sur les différentes fonctionnalités fournies par Freezable les objets, consultez La vue d’ensemble des objets Freezable.

Constructeurs

ByteAnimation()	Initialise une nouvelle instance de la classe ByteAnimation.
ByteAnimation(Byte, Byte, Duration)	Initialise une nouvelle instance de la classe ByteAnimation qui démarre l’animation en partant de la valeur de départ spécifiée jusqu’à la valeur de destination spécifiée pendant la durée spécifiée.
ByteAnimation(Byte, Byte, Duration, FillBehavior)	Initialise une nouvelle instance de la classe ByteAnimation qui démarre l’animation en partant de la valeur de départ spécifiée jusqu’à la valeur de destination spécifiée sur une durée donnée, et possède le comportement de remplissage spécifié.
ByteAnimation(Byte, Duration)	Initialise une nouvelle instance de la classe ByteAnimation qui effectue une animation vers la valeur spécifiée pendant la durée spécifiée. La valeur de départ de l’animation est la valeur de base de la propriété animée ou la sortie d’une autre animation.
ByteAnimation(Byte, Duration, FillBehavior)	Initialise une nouvelle instance de la classe ByteAnimation qui réalise une animation jusqu’à la valeur spécifiée sur une durée donnée et qui a le comportement de remplissage spécifié. La valeur de départ de l’animation est la valeur de base de la propriété animée ou la sortie d’une autre animation.

Champs

ByProperty	Identifie la propriété de dépendance By.
EasingFunctionProperty	Identifie la propriété de dépendance EasingFunction.
FromProperty	Identifie la propriété de dépendance From.
ToProperty	Identifie la propriété de dépendance To.

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)
By	Obtient ou définit la quantité totale par laquelle l’animation modifie sa valeur de départ.
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. (Hérité de Timeline)
DependencyObjectType	Obtient le DependencyObjectType qui encapsule le type CLR de ce 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)
EasingFunction	Obtient ou définit la fonction d’accélération appliquée à cette animation.
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)
From	Obtient ou définit la valeur de départ de l’animation.
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)
IsAdditive	Obtient ou définit une valeur qui indique si la valeur actuelle de la propriété cible doit être ajoutée à la valeur de départ de cette animation.
IsCumulative	Obtient ou définit une valeur qui indique si la valeur de l’animation s’accumule quand elle se répète.
IsDestinationDefault	Obtient une valeur qui indique si cette animation utilise le paramètre defaultDestinationValue de la méthode GetCurrentValue(Object, Object, AnimationClock) comme valeur de destination. (Hérité de AnimationTimeline)
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)
SpeedRatio	Obtient ou définit le taux de progression temporelle par rapport à son parent de ce Timeline. (Hérité de Timeline)
TargetPropertyType	Obtient le type de valeur généré par cette animation. (Hérité de ByteAnimationBase)
To	Obtient ou définit la valeur de fin de l’animation.

Méthodes

AllocateClock()	Crée un Clock pour ce AnimationTimeline. (Hérité de AnimationTimeline)
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 ByteAnimation, 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 Timeline, en effectuant une copie complète des valeurs actuelles de cet objet. (Hérité de Timeline)
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 AnimationClock à partir de ce AnimationTimeline. (Hérité de AnimationTimeline)
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 nouvelle instance de ByteAnimation.
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)
GetCurrentValue(Byte, Byte, AnimationClock)	Obtient la valeur actuelle de l’animation. (Hérité de ByteAnimationBase)
GetCurrentValue(Object, Object, AnimationClock)	Obtient la valeur actuelle de l’animation. (Hérité de ByteAnimationBase)
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)
GetCurrentValueCore(Byte, Byte, AnimationClock)	Calcule une valeur qui représente la valeur actuelle de la propriété animée, comme la détermine ByteAnimation.
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. (Hérité de Timeline)
GetNaturalDurationCore(Clock)	Retourne la durée d'une seule itération de ce AnimationTimeline. (Hérité de AnimationTimeline)
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)
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)
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. (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)

Voir aussi

• ByteAnimationUsingKeyFrames
• Freezable