Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

ThicknessAnimation, classe

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

Espace de noms :  System.Windows.Media.Animation
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public class ThicknessAnimation : ThicknessAnimationBase

Le type ThicknessAnimation expose les membres suivants.

  NomDescription
Méthode publiqueThicknessAnimation() Initialise une nouvelle instance de la classe ThicknessAnimation.
Méthode publiqueThicknessAnimation(Thickness, Duration)Initialise une nouvelle instance de la classe ThicknessAnimation qui s'anime à la valeur spécifiée sur une durée donnée. La valeur de début de l'animation correspond à la valeur de base de la propriété en cours d'animation ou à la valeur de sortie d'une autre animation.
Méthode publiqueThicknessAnimation(Thickness, Duration, FillBehavior)Initialise une nouvelle instance de la classe ThicknessAnimation qui s'anime à la valeur spécifiée sur une durée donnée et dont le comportement de remplissage correspond à celui défini. La valeur de début de l'animation correspond à la valeur de base de la propriété en cours d'animation ou à la valeur de sortie d'une autre animation.
Méthode publiqueThicknessAnimation(Thickness, Thickness, Duration) Initialise une nouvelle instance de la classe ThicknessAnimation qui s'anime de la valeur de début spécifiée à la valeur de destination définie sur la durée indiquée.
Méthode publiqueThicknessAnimation(Thickness, Thickness, Duration, FillBehavior) Initialise une nouvelle instance de la classe ThicknessAnimation qui s'anime de la valeur de début spécifiée à la valeur de destination définie sur la durée indiquée et dont le comportement de remplissage correspond à celui défini.
Début

  NomDescription
Propriété publiqueAccelerationRatioObtient 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. (Hérité de Timeline.)
Propriété publiqueAutoReverseObtient ou définit une valeur qui indique si la chronologie repart en arrière après avoir accompli une itération en avant. (Hérité de Timeline.)
Propriété publiqueBeginTimeObtient ou établit l'heure à laquelle ce Timeline doit commencer. (Hérité de Timeline.)
Propriété publiqueBy Obtient ou définit la valeur totale en fonction de laquelle l'animation modifie sa valeur de début.
Propriété publiqueCanFreezeObtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.)
Propriété publiqueDecelerationRatioObtient 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. (Hérité de Timeline.)
Propriété publiqueDependencyObjectTypeObtient le DependencyObjectType qui encapsule le type CLR de cette instance.  (Hérité de DependencyObject.)
Propriété publiqueDispatcherObtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publiqueDurationObtient ou définit la durée de cette chronologie, sans les répétitions. (Hérité de Timeline.)
Propriété publiqueEasingFunctionObtient ou définit la fonction d'accélération appliquée à cette animation.
Propriété publiqueFillBehaviorObtient 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. (Hérité de Timeline.)
Propriété publiqueFrom Obtient ou définit la valeur de début de l'animation.
Propriété publiqueHasAnimatedPropertiesObtient 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.)
Propriété publiqueIsAdditiveObtient ou définit une valeur qui indique si la valeur actuelle de la propriété cible doit être ajoutée à la valeur de début de cette animation.
Propriété publiqueIsCumulative Obtient ou définit une valeur qui spécifie si la valeur de l'animation est cumulée lorsqu'elle se répète.
Propriété publiqueIsDestinationDefaultObtient une valeur qui indique si cette animation doit utiliser le paramètre valeurDestinationDéfaut de la méthode GetCurrentValue comme valeur de destination. (Hérité de AnimationTimeline.)
Propriété publiqueIsFrozenObtient une valeur qui indique si l'objet est actuellement modifiable ou pas. (Hérité de Freezable.)
Propriété publiqueIsSealedRécupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
Propriété publiqueName Obtient ou définit le nom de ce Timeline. (Hérité de Timeline.)
Propriété publiqueRepeatBehaviorObtient ou définit le comportement à répétition de cette chronologie. (Hérité de Timeline.)
Propriété publiqueSpeedRatioObtient ou définit le taux de progression temporelle par rapport à son parent de ce Timeline. (Hérité de Timeline.)
Propriété publiqueTargetPropertyTypeObtient le type de valeur généré par cette animation. (Hérité de ThicknessAnimationBase.)
Propriété publiqueTo Obtient ou définit la valeur de fin de l'animation.
Début

  NomDescription
Méthode protégéeAllocateClockCrée un Clock pour ce AnimationTimeline. (Hérité de AnimationTimeline.)
Méthode publiqueApplyAnimationClock(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.)
Méthode publiqueApplyAnimationClock(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.)
Méthode publiqueBeginAnimation(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.)
Méthode publiqueBeginAnimation(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.)
Méthode publiqueCheckAccessDétermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publiqueClearValue(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.)
Méthode publiqueClearValue(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.)
Méthode publiqueCloneCrée un clone modifiable de ce ThicknessAnimation, en copiant intégralement toutes les valeurs de cet objet. Lors de la copie de propriétés de dépendance, cette méthode copie les références de ressources et les liaisons de données (même si elles ne peuvent plus être résolues), mais pas les animations ni leurs valeurs actuelles.
Méthode protégéeCloneCoreConvertit 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.)
Méthode publiqueCloneCurrentValueCrée un clone modifiable de cet objet Timeline, en créant des copies complètes des valeurs actuelles de cet objet. (Hérité de Timeline.)
Méthode protégéeCloneCurrentValueCoreConvertit 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.)
Méthode publiqueCoerceValueForce 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.)
Méthode publiqueCreateClock()Crée une nouvelle horloge AnimationClock à partir de la chronologie AnimationTimeline. (Hérité de AnimationTimeline.)
Méthode publiqueCreateClock(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. (Hérité de Timeline.)
Méthode protégéeCreateInstanceInitialise une nouvelle instance de la classe Freezable. (Hérité de Freezable.)
Méthode protégéeCreateInstanceCoreCrée une nouvelle instance de ThicknessAnimation. (Substitue Freezable.CreateInstanceCore().)
Méthode publiqueEqualsDétermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
Méthode protégéeFinalize Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)
Méthode publiqueFreeze()Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.)
Méthode protégéeFreezeCoreRend cet objet Timeline non modifiable ou détermine s'il peut être rendu non modifiable. (Hérité de Timeline.)
Méthode publiqueGetAnimationBaseValueRetourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable.)
Méthode publiqueGetAsFrozenCré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.)
Méthode protégéeGetAsFrozenCoreConvertit cette instance en clone de l'objet Timeline spécifié. (Hérité de Timeline.)
Méthode publiqueGetCurrentValue(Object, Object, AnimationClock)Obtient la valeur actuelle de l'animation. (Hérité de ThicknessAnimationBase.)
Méthode publiqueGetCurrentValue(Thickness, Thickness, AnimationClock)Obtient la valeur actuelle de l'animation. (Hérité de ThicknessAnimationBase.)
Méthode publiqueGetCurrentValueAsFrozenCré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.)
Méthode protégéeGetCurrentValueAsFrozenCoreConvertit 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. (Hérité de Timeline.)
Méthode protégéeGetCurrentValueCoreCalcule une valeur qui représente la valeur actuelle de la propriété en cours d'animation, déterminée par l'ThicknessAnimation. (Substitue ThicknessAnimationBase.GetCurrentValueCore(Thickness, Thickness, AnimationClock).)
Méthode publiqueGetHashCodeObtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueGetLocalValueEnumeratorCré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.)
Méthode protégéeGetNaturalDurationRetourne la durée d'une seule itération de ce Timeline. (Hérité de Timeline.)
Méthode protégéeGetNaturalDurationCoreRetourne la durée d'une seule itération de ce AnimationTimeline. (Hérité de AnimationTimeline.)
Méthode publiqueGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiqueGetValueRetourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode publiqueInvalidatePropertyRéévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
Méthode protégéeMemberwiseCloneCrée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégéeOnChangedAppelé lors de la modification de l'objet Freezable actuel. (Hérité de Freezable.)
Méthode protégéeOnFreezablePropertyChanged(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.)
Méthode protégéeOnFreezablePropertyChanged(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.)
Méthode protégéeOnPropertyChangedSubstitue 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.)
Méthode publiqueReadLocalValueRetourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode protégéeReadPreambleGarantit 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.)
Méthode publiqueSetCurrentValueDéfinit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
Méthode publiqueSetValue(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.)
Méthode publiqueSetValue(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.)
Méthode protégéeShouldSerializePropertyRetourne 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.)
Méthode publiqueToStringRetourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publiqueVerifyAccessGarantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Méthode protégéeWritePostscriptDé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.)
Méthode protégéeWritePreambleVé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

  NomDescription
Événement publicChangedSe produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable.)
Événement publicCompletedSe produit lorsque cette chronologie est complètement terminée et n'entrera plus dans sa période active. (Hérité de Timeline.)
Événement publicCurrentGlobalSpeedInvalidatedSe produit lorsque le taux auquel l'heure progresse pour l'horloge de la chronologie change. (Hérité de Timeline.)
Événement publicCurrentStateInvalidatedSe produit lorsque la propriété CurrentState du Clock de la chronologie est mise à jour. (Hérité de Timeline.)
Événement publicCurrentTimeInvalidatedSe produit lorsque la propriété CurrentTime du Clock de la chronologie est mise à jour. (Hérité de Timeline.)
Événement publicRemoveRequestedSe produit lorsque l'horloge créée pour cette chronologie ou une de ses chronologies parentes est supprimée. (Hérité de Timeline.)
Début

  NomDescription
Champ publicMembre statiqueByProperty Identifie la propriété de dépendance By.
Champ publicMembre statiqueEasingFunctionPropertyIdentifie la propriété de dépendance EasingFunction.
Champ publicMembre statiqueFromProperty Identifie la propriété de dépendance From.
Champ publicMembre statiqueToProperty Identifie la propriété de dépendance To.
Début

Une animation met à jour la valeur d'une propriété au cours d'une période donnée. Les conséquences d'une animation peuvent être infimes (déplacement d'un Shape de quelques pixels vers la gauche ou vers la droite, par exemple) ou conséquentes (multiplication de la taille d'un objet par 200 par rapport à sa taille d'origine tout en le faisant pivoter et en modifiant sa couleur, par exemple). Pour créer une animation dans Windows Presentation Foundation (WPF), il vous suffit d'associer une animation à la valeur de propriété d'un objet.

Valeurs cibles

La classe ThicknessAnimation crée une transition entre deux valeurs cibles. Pour définir ses valeurs cibles, utilisez ses propriétés From, To et By. Le tableau suivant récapitule comment les propriétés From, To et By peuvent être utilisées pour déterminer les valeurs cibles d'une animation.

Propriétés spécifiées

Comportement résultant

From

L'animation passe de la valeur définie par la propriété From à la valeur de base de la propriété en cours d'animation ou à la valeur de sortie de l'animation qui la précède en fonction de la configuration de cette dernière.

From et To

L'animation passe de la valeur définie par la propriété From à la valeur définie par la propriété To.

From et By

L'animation passe de la valeur définie par la propriété From à la valeur définie par la somme des propriétés From et By.

To

L'animation passe de la valeur de base de la propriété animée ou de la valeur de sortie de l'animation qui la précède à la valeur définie par la propriété To.

By

L'animation passe de la valeur de base de la propriété en cours d'animation ou de la valeur de sortie de l'animation qui la précède à la somme de cette dernière valeur et de la valeur définie par la propriété By.

RemarqueRemarque

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

Pour utiliser d'autres méthodes d'interpolation ou effectuer une animation entre plusieurs valeurs cibles, utilisez un objet ThicknessAnimationUsingKeyFrames.

Pour plus d'informations sur l'application de plusieurs animations à une propriété unique, consultez Vue d'ensemble des animations d'image clé.

Fonctionnalités Freezable

Comme la classe ThicknessAnimation hérite de Freezable, les objets ThicknessAnimation disposent de plusieurs fonctionnalités spéciales : ils peuvent notamment être déclarés en tant que ressources, partagés entre plusieurs objets, configurés en lecture seule pour améliorer les performances, clonés ou thread-safe. Pour plus d'informations sur les différentes fonctionnalités fournies par les objets Freezable, consultez Vue d'ensemble des objets Freezable.

.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

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.

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.
Afficher: