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

MatrixAnimationUsingKeyFrames, classe

Anime la valeur d'une propriété Matrix en fonction d'un ensemble de KeyFrames.

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.MatrixAnimationBase
                System.Windows.Media.Animation.MatrixAnimationUsingKeyFrames

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
[ContentPropertyAttribute("KeyFrames")]
public class MatrixAnimationUsingKeyFrames : MatrixAnimationBase, 
	IKeyFrameAnimation, IAddChild
<MatrixAnimationUsingKeyFrames>
  KeyFrames
</MatrixAnimationUsingKeyFrames>

Le type MatrixAnimationUsingKeyFrames expose les membres suivants.

  Nom Description
Méthode publique MatrixAnimationUsingKeyFrames Initialise une nouvelle instance de la classe MatrixAnimationUsingKeyFrames.
Début
  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 MatrixKeyFrame 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 MatrixAnimationBase.)
Début
  Nom Description
Méthode protégée AddChild Ajoute un enfant MatrixKeyFrame à ce MatrixAnimationUsingKeyFrames.
Méthode protégée AddText Ajoute une chaîne de texte en tant qu'enfant de ce MatrixAnimationUsingKeyFrames.
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 MatrixAnimationUsingKeyFrames 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 MatrixAnimationUsingKeyFrames 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 MatrixAnimationUsingKeyFrames, 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 MatrixAnimationUsingKeyFrames 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 MatrixAnimationUsingKeyFrames. (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 netto***ge 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 Rend cette instance d'objet MatrixAnimationUsingKeyFrames non modifiable ou indique si elle peut être rendue non modifiable. (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é MatrixAnimationUsingKeyFrames. (Substitue Timeline.GetAsFrozenCore(Freezable).)
Méthode publique GetCurrentValue(Matrix, Matrix, AnimationClock) Obtient la valeur actuelle de l'animation. (Hérité de MatrixAnimationBase.)
Méthode publique GetCurrentValue(Object, Object, AnimationClock) Obtient la valeur actuelle de l'animation. (Hérité de MatrixAnimationBase.)
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 MatrixAnimationUsingKeyFrames 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 la valeur de sortie actuelle de ce MatrixAnimationUsingKeyFrames. (Substitue MatrixAnimationBase.GetCurrentValueCore(Matrix, Matrix, 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 MatrixAnimationUsingKeyFrames 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 MatrixAnimationUsingKeyFrames 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
  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
  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 une collection ordonnée KeyFrames associée à cette séquence d'animation.
Début

Les valeurs cibles de l'animation d'une image clé sont définies par sa propriété KeyFrames, laquelle contient une collection d'objets MatrixKeyFrame. Chaque MatrixKeyFrame 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.

This example shows how to animate the Matrix property of a MatrixTransform by using key frames.

The following example uses the MatrixAnimationUsingKeyFrames class to animate the Matrix property of a MatrixTransform. The example uses the MatrixTransform object to transform the appearance and position of a Button.

This animation uses the DiscreteMatrixKeyFrame class to create two key frames and does the following with them:

  1. Animates the first Matrix during the first 0.2 seconds. The example changes the M11 and M12 properties of the Matrix. This change causes the button to stretch and become skewed. The example also changes the OffsetX and OffsetY properties so that the button changes position.

  2. Animates the second Matrix at 1.0 seconds. The button moves to another position while the button is no longer skewed or stretched.

  3. Repeats the animation indefinitely.

Remarque Remarque

Key frames that derive from the DiscreteMatrixKeyFrame object create sudden jumps between values, that is, the movement of the animation is jerky.


<Page 
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
  Title="MatrixAnimationUsingPath Example">
  <StackPanel Margin="20">
    <Canvas HorizontalAlignment="Left" Width="340" Height="240" >

      <!-- The Button that is animated. -->
      <Button Margin="-30,0,0,0" MinWidth="100">
        Click
        <Button.RenderTransform>
          <MatrixTransform x:Name="myMatrixTransform">
            <MatrixTransform.Matrix >
              <Matrix OffsetX="10" OffsetY="100"/>
            </MatrixTransform.Matrix>
          </MatrixTransform>
        </Button.RenderTransform>
        <Button.Triggers>
          <EventTrigger RoutedEvent="Button.Loaded">
            <BeginStoryboard>
              <Storyboard>

                <!-- Animates the button's MatrixTransform using MatrixAnimationUsingKeyFrames. 
                Animates to first Matrix in the first 0.2 seconds, to second Matrix in the next
                second, and then starts over. Notice that the first KeyFrame stretches the button
                and skews it using the M11 and M12 Matrix properties respectively. Also, animations are 
                using Discrete interpolation, so the MatrixTransform appears to "jump" from one value 
                to the next. -->
                <MatrixAnimationUsingKeyFrames
                Storyboard.TargetName="myMatrixTransform"
                Storyboard.TargetProperty="Matrix"
                Duration="0:0:3" 
                RepeatBehavior="Forever">
                  <DiscreteMatrixKeyFrame KeyTime="0:0:0.2">
                    <DiscreteMatrixKeyFrame.Value>
                      <Matrix OffsetX="100" OffsetY="200" M11="3" M12="1" />
                    </DiscreteMatrixKeyFrame.Value>
                  </DiscreteMatrixKeyFrame>
                  <DiscreteMatrixKeyFrame KeyTime="0:0:1">
                    <DiscreteMatrixKeyFrame.Value>
                      <Matrix OffsetX="300" OffsetY="100" M11="1" M12="0" />
                    </DiscreteMatrixKeyFrame.Value>
                  </DiscreteMatrixKeyFrame>
                </MatrixAnimationUsingKeyFrames>
              </Storyboard>
            </BeginStoryboard>
          </EventTrigger>

        </Button.Triggers>
      </Button>

    </Canvas>
  </StackPanel>
</Page>


For the complete sample, see KeyFrame Animation Sample.

.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.
Cela vous a-t-il été utile ?
(1500 caractères restants)
Contenu de la communauté Ajouter
Annotations FAQ
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,