ColorAnimationUsingKeyFrames Class

Anime la valeur d'une propriété de Color sur un ensemble d'images clés.

Héritage

Object
  DependencyObject
    Timeline
      ColorAnimationUsingKeyFrames

Syntaxe


public sealed class ColorAnimationUsingKeyFrames : Timeline


<ColorAnimationUsingKeyFrames ...>
  oneOrMoreColorKeyFrames
</ColorAnimationUsingKeyFrames>

XAML Values

oneOrMoreColorKeyFrames

Un ou plusieurs éléments objet qui définissent les images clés de l'animation. Ces éléments objet représentent l'une des classes qui dérivent du ColorKeyFrame. Il s'agit en général de toute combinaison de LinearColorKeyFrame, DiscreteColorKeyFrame, EasingColorKeyFrame et SplineColorKeyFrame. Les éléments objet définis ici deviennent membres de la collection lorsque le code accède à la propriété ColorAnimationUsingKeyFrames.KeyFrames au moment de l'exécution.

Attributs

[ContentProperty("Name=KeyFrames")]
[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Membres

ColorAnimationUsingKeyFramesClasse possède ces types de membres :

Constructeurs

ColorAnimationUsingKeyFramesClasse possède ces constructeurs.

ConstructeurDescription
ColorAnimationUsingKeyFrames Initializes a new instance of the ColorAnimationUsingKeyFrames class.

 

Événements

ColorAnimationUsingKeyFramesClasse possède ces événements.

ÉvénementDescription
Completed Occurs when the Storyboard object has completed playing. (Hérité de Timeline)

 

Méthodes

The ColorAnimationUsingKeyFrames Classe a les méthodes suivantes. Elle hérite également des méthodes de Object Classe.

MéthodeDescription
ClearValue Clears the local value of a dependency property. (Hérité de DependencyObject)
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (Hérité de DependencyObject)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (Hérité de DependencyObject)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (Hérité de DependencyObject)
SetValue Sets the local value of a dependency property on a DependencyObject. (Hérité de DependencyObject)

 

Propriétés

Le ColorAnimationUsingKeyFramesClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

AutoReverse

Lecture/écritureGets or sets a value that indicates whether the timeline plays in reverse after it completes a forward iteration. (Hérité de Timeline)

BeginTime

Lecture/écritureGets or sets the time at which this Timeline should begin. (Hérité de Timeline)

Dispatcher

En lecture seuleGets the CoreDispatcher that this object is associated with. (Hérité de DependencyObject)

Duration

Lecture/écritureGets or sets the length of time for which this timeline plays, not counting repetitions. (Hérité de Timeline)

EnableDependentAnimation

Lecture/écritureGets or sets a value that declares whether animated properties that are considered dependent animations should be permitted to use this animation declaration.

EnableDependentAnimationProperty

En lecture seuleIdentifies the EnableDependentAnimation dependency property.

FillBehavior

Lecture/écritureGets or sets a value that specifies how the animation behaves after it reaches the end of its active period. (Hérité de Timeline)

KeyFrames

En lecture seuleGets the collection of ColorKeyFrame objects that define the animation.

RepeatBehavior

Lecture/écritureGets or sets the repeating behavior of this timeline. (Hérité de Timeline)

SpeedRatio

Lecture/écritureGets or sets the rate, relative to its parent, at which time progresses for this Timeline. (Hérité de Timeline)

 

Exemples

L'exemple suivant utilise la classe ColorAnimationUsingKeyFrames pour animer la propriété Background de StackPanel. Cette animation utilise trois images clés de la manière suivante :

  1. Pendant les deux premières secondes, LinearColorKeyFrame change progressivement la couleur du vert au rouge. Les images clés linéaires telles que LinearColorKeyFrame créent une transition linéaire fluide entre les valeurs.

  2. À la fin de la demi-seconde suivante, DiscreteColorKeyFrame change rapidement la couleur du rouge au jaune. Les images clés discrètes telles que DiscreteColorKeyFrame créent des changements soudains entre les valeurs ; l'animation se produit alors rapidement sans aucune interpolation entre les valeurs.

  3. Pendant les deux dernières secondes, SplineColorKeyFrame change à nouveau la couleur, cette fois du jaune au vert. Les images clés de spline telles que SplineColorKeyFrame créent une transition variable entre des valeurs en fonction des valeurs de la propriété KeySpline. KeySpline permet de modifier la relation temps/valeur pendant la durée de l'animation pour la rendre non linéaire. Plus particulièrement, la relation peut être une courbe qui serait difficile à générer avec des images clés individuelles. Dans cet exemple, la modification de couleur commence lentement et accélère de façon exponentielle vers la fin du segment temporel.


<StackPanel x:Name="myStackPanel" Background="Red"
Loaded="Start_Animation">
    <StackPanel.Resources>
        <Storyboard x:Name="colorStoryboard">

            <ColorAnimationUsingKeyFrames Storyboard.TargetName="myStackPanel" 
      Storyboard.TargetProperty="(Panel.Background).(SolidColorBrush.Color)">
                
                <!-- Go from green to red in the first 2 seconds. LinearColorKeyFrame creates
                a smooth, linear animation between values. -->
                <LinearColorKeyFrame Value="Blue" KeyTime="00:00:02" />

                <!-- In the next half second, go to yellow. DiscreteColorKeyFrame creates a 
                sudden jump between values. -->
                <DiscreteColorKeyFrame Value="Yellow" KeyTime="00:00:2.5" />

                <!-- In the final 2 seconds of the animation, go from yellow back to green. SplineColorKeyFrame 
                creates a variable transition between values depending on the KeySpline property. In this example,
                the animation starts off slow but toward the end of the time segment, it speeds up exponentially.-->
                <SplineColorKeyFrame Value="Green" KeyTime="00:00:4.5" KeySpline="0.6,0.0 0.9,0.00" />

            </ColorAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>
</StackPanel>



// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    colorStoryboard.Begin();
}


Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Espace de noms

Windows.UI.Xaml.Media.Animation
Windows::UI::Xaml::Media::Animation [C++]

Métadonnées

Windows.winmd

Voir aussi

Animations avec table de montage séquentiel

 

 

Afficher:
© 2015 Microsoft