ObjectAnimationUsingKeyFrames, classe (System.Windows.Media.Animation)

Changer de vue:
Classique
Lightweight
ScriptFree
Bibliothèque de classes .NET Framework
ObjectAnimationUsingKeyFrames, classe
Cet article a fait l'objet d'une traduction manuelle. Pour afficher simultanément cette page et le contenu source en anglais, choisissez le paramètre d'affichage Basse densité.

Anime la valeur d'une propriété Object selon un ensemble de KeyFrames et en fonction d'une duréeDurationspécifiée.

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.ObjectAnimationBase
                System.Windows.Media.Animation.ObjectAnimationUsingKeyFrames

Espace de noms :  System.Windows.Media.Animation
Assembly :  PresentationCore (dans PresentationCore.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
Syntaxe
Visual Basic
<ContentPropertyAttribute("KeyFrames")> _
Public Class ObjectAnimationUsingKeyFrames _
	Inherits ObjectAnimationBase _
	Implements IKeyFrameAnimation, IAddChild
C#
[ContentPropertyAttribute("KeyFrames")]
public class ObjectAnimationUsingKeyFrames : ObjectAnimationBase, 
	IKeyFrameAnimation, IAddChild
VisualC++
[ContentPropertyAttribute(L"KeyFrames")]
public ref class ObjectAnimationUsingKeyFrames : public ObjectAnimationBase, 
	IKeyFrameAnimation, IAddChild
F#
[<ContentPropertyAttribute("KeyFrames")>]
type ObjectAnimationUsingKeyFrames =  
    class
        inherit ObjectAnimationBase
        interface IKeyFrameAnimation
        interface IAddChild
    end
Utilisation des éléments objets XAML
<ObjectAnimationUsingKeyFrames>
  KeyFrames
</ObjectAnimationUsingKeyFrames>

Le type ObjectAnimationUsingKeyFrames expose les membres suivants.

Constructeurs
  Nom Description
Méthode publique ObjectAnimationUsingKeyFrames Initialise une nouvelle instance de la classe ObjectAnimationUsingKeyFrames.
Début
Propriétés
  Nom Description
Propriété publique 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. (Hérité de Timeline.)
Propriété publique 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. (Hérité de Timeline.)
Propriété publique BeginTime Obtient ou établit l'heure à laquelle ce Timeline doit commencer. (Hérité de Timeline.)
Propriété publique CanFreeze Obtient une valeur qui indique la possibilité ou non de rendre un objet non modifiable. (Hérité de Freezable.)
Propriété publique 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. (Hérité de Timeline.)
Propriété publique DependencyObjectType Obtient le DependencyObjectType qui encapsule le type CLR de cette instance.  (Hérité de DependencyObject.)
Propriété publique Dispatcher Obtient le Dispatcher associé à DispatcherObject. (Hérité de DispatcherObject.)
Propriété publique Duration Obtient ou définit la durée de cette chronologie, sans les répétitions. (Hérité de Timeline.)
Propriété publique 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. (Hérité de Timeline.)
Propriété publique 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.)
Propriété publique IsDestinationDefault Obtient 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é publique IsFrozen Obtient une valeur qui indique si l'objet est actuellement modifiable ou pas. (Hérité de Freezable.)
Propriété publique IsSealed Récupère une valeur qui indique si cette instance est actuellement sealed (en lecture seule). (Hérité de DependencyObject.)
Propriété publique KeyFrames Obtient ou définit la collection des objets ObjectKeyFrame qui définissent l'animation.
Propriété publique Name Obtient ou définit le nom de ce Timeline. (Hérité de Timeline.)
Propriété publique RepeatBehavior Obtient ou définit le comportement à répétition de cette chronologie. (Hérité de Timeline.)
Propriété publique SpeedRatio Obtient ou définit le taux de progression temporelle par rapport à son parent de ce Timeline. (Hérité de Timeline.)
Propriété publique TargetPropertyType Obtient le type de valeur généré par cette animation. (Hérité de ObjectAnimationBase.)
Début
Méthodes
  Nom Description
Méthode protégée AddChild Ajoute un enfant ObjectKeyFrame à ce ObjectAnimationUsingKeyFrames.
Méthode protégée AddText Ajoute une chaîne de texte en tant qu'enfant de ce ObjectAnimationUsingKeyFrames.
Méthode protégée AllocateClock Crée un Clock pour ce AnimationTimeline. (Hérité de AnimationTimeline.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique CheckAccess Détermine si le thread appelant a accès à ce DispatcherObject. (Hérité de DispatcherObject.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique Clone Crée un clone modifiable de ce ObjectAnimationUsingKeyFrames en copiant intégralement toutes ses valeurs. 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ée CloneCore Convertit cette instance en copie complète du ObjectAnimationUsingKeyFrames spécifié. Lors de la copie de propriétés de dépendance, cette méthode copie les références des ressources et les liaisons aux données (même si elles ne peuvent plus être résolues), mais pas les animations et leurs valeurs actuelles. (Substitue Freezable.CloneCore(Freezable).)
Méthode publique CloneCurrentValue Crée un clone modifiable de cet objet ObjectAnimationUsingKeyFrames, en créant des copies complètes des valeurs actuelles de cet objet. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées.
Méthode protégée CloneCurrentValueCore Convertit cette instance en copie complète modifiable du ObjectAnimationUsingKeyFrames spécifié à l'aide des valeurs de propriétés actuelles. Contrairement à leurs valeurs actuelles, les références de ressources, les liaisons de données et les animations ne sont pas copiées. (Substitue Freezable.CloneCurrentValueCore(Freezable).)
Méthode publique 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.)
Méthode publique CreateClock Crée une nouvelle horloge AnimationClock à partir de la chronologie AnimationTimeline. (Hérité de AnimationTimeline.)
Méthode publique 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. (Hérité de Timeline.)
Méthode protégée CreateInstance Initialise une nouvelle instance de la classe Freezable. (Hérité de Freezable.)
Méthode protégée CreateInstanceCore Crée une nouvelle instance de ObjectAnimationUsingKeyFrames. (Substitue Freezable.CreateInstanceCore.)
Méthode publique Equals Détermine si un DependencyObject fourni est équivalent au DependencyObject réel. (Hérité de DependencyObject.)
Méthode protégée Finalize 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 publique Freeze Rend l'objet actuel non modifiable et définit sa propriété IsFrozen sur true. (Hérité de Freezable.)
Méthode protégée FreezeCore Convertit cette instance d'objet ObjectAnimationUsingKeyFrames en instance accessible en lecture seule uniquement ou détermine si une telle conversion est possible. (Substitue Timeline.FreezeCore(Boolean).)
Méthode publique GetAnimationBaseValue Retourne la valeur non animée de la propriété DependencyProperty spécifiée. (Hérité de Animatable.)
Méthode publique 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.)
Méthode protégée GetAsFrozenCore Convertit cette instance en clone de l'objet spécifié ObjectAnimationUsingKeyFrames. (Substitue Timeline.GetAsFrozenCore(Freezable).)
Méthode publique GetCurrentValue Obtient la valeur actuelle de l'animation. (Hérité de ObjectAnimationBase.)
Méthode publique 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.)
Méthode protégée GetCurrentValueAsFrozenCore Convertit cette instance en clone figé du ObjectAnimationUsingKeyFrames 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 Timeline.GetCurrentValueAsFrozenCore(Freezable).)
Méthode protégée GetCurrentValueCore Calcule une valeur qui représente la valeur actuelle de la propriété en cours d'animation, tel que déterminé par cette instance de ObjectAnimationUsingKeyFrames. (Substitue ObjectAnimationBase.GetCurrentValueCore(Object, Object, AnimationClock).)
Méthode publique GetHashCode Obtient un code de hachage pour ce DependencyObject. (Hérité de DependencyObject.)
Méthode publique 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.)
Méthode protégée GetNaturalDuration Retourne la durée d'une seule itération de ce Timeline. (Hérité de Timeline.)
Méthode protégée GetNaturalDurationCore Fournissez un Duration naturel personnalisé lorsque la propriété Duration a la valeur Automatic. (Substitue AnimationTimeline.GetNaturalDurationCore(Clock).)
Méthode publique GetType Obtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publique GetValue Retourne la valeur effective actuelle d'une propriété de dépendance sur cette instance d'un DependencyObject. (Hérité de DependencyObject.)
Méthode publique InvalidateProperty Réévalue la valeur effective pour la propriété de dépendance spécifiée (Hérité de DependencyObject.)
Méthode protégée MemberwiseClone Crée une copie superficielle de l'objet Object actif. (Hérité de Object.)
Méthode protégée OnChanged Appelé lorsque l'objet ObjectAnimationUsingKeyFrames actuel est modifié. (Substitue Freezable.OnChanged.)
Méthode protégée 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.)
Méthode protégée 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.)
Méthode protégée 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.)
Méthode publique ReadLocalValue Retourne la valeur de proximité d'une propriété de dépendance, si elle existe. (Hérité de DependencyObject.)
Méthode protégée 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.)
Méthode publique SetCurrentValue Définit la valeur d'une propriété de dépendance sans modifier sa source de valeur. (Hérité de DependencyObject.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique ShouldSerializeKeyFrames Retourne la valeur true si la valeur de la propriété KeyFrames de cette instance de ObjectAnimationUsingKeyFrames doit être sérialisée par valeur.
Méthode protégée 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.)
Méthode publique ToString Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.)
Méthode publique VerifyAccess Garantit que le thread appelant a accès à DispatcherObject. (Hérité de DispatcherObject.)
Méthode protégée 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.)
Méthode protégée 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
Événement public Changed Se produit lorsque Freezable ou un objet qu'il contient est modifié. (Hérité de Freezable.)
Événement public Completed Se produit lorsque cette chronologie est complètement terminée et n'entrera plus dans sa période active. (Hérité de Timeline.)
Événement public CurrentGlobalSpeedInvalidated Se produit lorsque le taux auquel l'heure progresse pour l'horloge de la chronologie change. (Hérité de Timeline.)
Événement public CurrentStateInvalidated Se produit lorsque la propriété CurrentState du Clock de la chronologie est mise à jour. (Hérité de Timeline.)
Événement public CurrentTimeInvalidated Se produit lorsque la propriété CurrentTime du Clock de la chronologie est mise à jour. (Hérité de Timeline.)
Événement public RemoveRequested Se produit lorsque l'horloge créée pour cette chronologie ou une de ses chronologies parentes est supprimée. (Hérité de Timeline.)
Début
Implémentations d'interface explicite
  Nom Description
Implémentation d'interface explicite Méthode privée IAddChild.AddChild Ajoute un objet enfant.
Implémentation d'interface explicite Méthode privée IAddChild.AddText Ajoute le texte d'un nœud à l'objet.
Implémentation d'interface explicite Propriété privée IKeyFrameAnimation.KeyFrames Obtient ou définit un collection ordonnée P:System.Windows.Media.Animation.IKeyFrameAnimation.KeyFrames associée à cette séquence d'animation.
Début
Notes

Les valeurs cibles de l'animation d'une image clé sont définies par sa propriété KeyFrames, laquelle contient une collection d'objets ObjectKeyFrame. Chaque ObjectKeyFrame définit un segment de l'animation avec ses propres Value et KeyTime cibles. Lors de l'exécution de l'animation, celle-ci passe d'une valeur de clé à la suivante en fonction des périodes de clé spécifiées.

Animation des images clé d'un ObjectAnimationUsingKeyFrames

Vous ne pouvez pas animer un objet qui correspond à la sortie d'une autre animation. Par exemple, si vous utilisez un ObjectAnimationUsingKeyFrames pour animer le Fill d'un Rectangle à partir d'un RadialGradientBrush vers un SolidColorBrush, vous ne pouvez animer aucune des propriétés du RadialGradientBrush ni du SolidColorBrush quelles qu'elles soient.

Exemples

This example shows how to animate an object, which in this example is the Background property of a Page control, by using key frames.

The following example uses the ObjectAnimationUsingKeyFrames class to animate color changes for the Background property of a Page control. The example animation changes to a different background brush at regular intervals. This animation uses the DiscreteObjectKeyFrame class to create three different key frames. The animation uses key frames in the following manner:

  1. At the end of the first second, animates an instance of the LinearGradientBrush class. This section of the example applies a linear gradient to the background color so that the color transitions from yellow to orange to red.

  2. At the end of the next second, animates an instance of the RadialGradientBrush class. This section of the example applies a radial gradient to the background color so that the color transitions from white to blue to black.

  3. At the end of the third second, animates an instance of the DrawingBrush class. This section of the example applies a checkerboard pattern to the background.

  4. The animation begins again and repeats indefinitely.

Remarque Remarque

DiscreteObjectKeyFrame is the only type of key frame that you can use with the ObjectAnimationUsingKeyFrames class. Key frames like DiscreteObjectKeyFrame create sudden changes in values, that is, the color changes in this example occur suddenly.
XAML

<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" >
    <Page.Triggers>
      <EventTrigger RoutedEvent="Page.Loaded">
        <BeginStoryboard>
          <Storyboard>

            <!-- ObjectAnimationUsingKeyFrames is used to animate properties that take
                 an object as a value. This animation lasts for 4 seconds using 3 KeyFrames which
                 swap different brush objects at regular intervals, making the background of the Page
                 change. -->
            <ObjectAnimationUsingKeyFrames
              Storyboard.TargetProperty="Background"
              Duration="0:0:4" RepeatBehavior="Forever">
            <ObjectAnimationUsingKeyFrames.KeyFrames>

              <!-- Note: Only discrete interpolation (DiscreteObjectKeyFrame) is available for 
              use with ObjectAnimationUsingKeyFrames which merely swaps objects according to
              a specified timeline. Other types of interpolation are too problematic to apply
              to objects.  -->

              <!-- Using a DiscreteObjectKeyFrame, the Page Background suddenly changes 
                   to a LinearGradientBrush after the first second of the animation. -->
              <DiscreteObjectKeyFrame KeyTime="0:0:1">
                <DiscreteObjectKeyFrame.Value>
                  <LinearGradientBrush>
                    <LinearGradientBrush.GradientStops>
                      <GradientStop Color="Yellow" Offset="0.0" />
                      <GradientStop Color="Orange" Offset="0.5" />
                      <GradientStop Color="Red" Offset="1.0" />
                    </LinearGradientBrush.GradientStops>
                  </LinearGradientBrush>
                </DiscreteObjectKeyFrame.Value>
              </DiscreteObjectKeyFrame>

              <!-- Using a DiscreteObjectKeyFrame, the Page Background suddenly changes 
                   to a RadialGradientBrush after the second second of the animation. -->
              <DiscreteObjectKeyFrame KeyTime="0:0:2">
                <DiscreteObjectKeyFrame.Value>
                  <RadialGradientBrush GradientOrigin="0.75,0.25">
                    <RadialGradientBrush.GradientStops>
                      <GradientStop Color="White" Offset="0.0" />
                      <GradientStop Color="MediumBlue" Offset="0.5" />
                      <GradientStop Color="Black" Offset="1.0" />
                    </RadialGradientBrush.GradientStops>
                  </RadialGradientBrush>
                </DiscreteObjectKeyFrame.Value>
              </DiscreteObjectKeyFrame>

              <!-- Using a DiscreteObjectKeyFrame, the Page Background suddenly 
                   changes to a DrawingBrush (creates a checkerboard pattern) after the 
                   third second of the animation. -->
              <DiscreteObjectKeyFrame KeyTime="0:0:3">
                <DiscreteObjectKeyFrame.Value>
                  <DrawingBrush Viewport="0,0,0.25,0.25" TileMode="Tile">
                    <DrawingBrush.Drawing>
                      <DrawingGroup>
                        <DrawingGroup.Children>
                          <GeometryDrawing Brush="White">
                            <GeometryDrawing.Geometry>
                              <RectangleGeometry Rect="0,0,1,1" />
                            </GeometryDrawing.Geometry>
                          </GeometryDrawing>
                          <GeometryDrawing Brush="Black"
                           Geometry="M 0,0 L0,0.5 0.5,0.5 0.5,1 1,1 1,0.5 0.5,0.5 0.5,0" />
                        </DrawingGroup.Children>
                      </DrawingGroup>
                    </DrawingBrush.Drawing>
                  </DrawingBrush>
                </DiscreteObjectKeyFrame.Value>
              </DiscreteObjectKeyFrame>          
            </ObjectAnimationUsingKeyFrames.KeyFrames>
          </ObjectAnimationUsingKeyFrames>        
        </Storyboard>
      </BeginStoryboard>
    </EventTrigger>
  </Page.Triggers>
</Page>

For the complete sample, see KeyFrame Animation Sample.

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 des animations d'image clé
Animation d'image clé, exemple