ObjectAnimationUsingKeyFrames, classe
TOC
Réduire la table des matières
Développer la table des matières

ObjectAnimationUsingKeyFrames Class

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

Héritage

Object
  DependencyObject
    Timeline
      ObjectAnimationUsingKeyFrames

Syntaxe


public sealed class ObjectAnimationUsingKeyFrames : Timeline


<ObjectAnimationUsingKeyFrames>oneOrMoreDiscreteObjectKeyFrames</ObjectAnimationUsingKeyFrames>

XAML Values

oneOrMoreDiscreteObjectKeyFrames

Un ou plusieurs éléments objet DiscreteObjectKeyFrame qui définissent les frames importants de l'animation.

Attributs

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

Membres

ObjectAnimationUsingKeyFramesClasse possède ces types de membres :

Constructeurs

ObjectAnimationUsingKeyFramesClasse possède ces constructeurs.

ConstructeurDescription
ObjectAnimationUsingKeyFrames Initializes a new instance of the ObjectAnimationUsingKeyFrames class.

 

Événements

ObjectAnimationUsingKeyFramesClasse possède ces événements.

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

 

Méthodes

The ObjectAnimationUsingKeyFrames 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 ObjectAnimationUsingKeyFramesClasse 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 ObjectKeyFrame 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 ObjectAnimationUsingKeyFrames pour animer la propriété Fill de Rectangle. Cette animation utilise deux images clés de la manière suivante :

  1. À l'aide d'un DiscreteObjectKeyFrame, la propriété Fill du Rectangle se transforme soudainement en LinearGradientBrush après les deux premières secondes de l'animation.

  2. Après la troisième seconde de l'animation, la propriété Fill est modifiée soudainement en un LinearGradientBrush différent, qui est conservé jusqu'à la fin de l'animation (quatre secondes au total).


<StackPanel>
    <StackPanel.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- 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.TargetName="animatedRectangle"
         Storyboard.TargetProperty="Fill"
         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 Fill property of the Rectangle suddenly  
                changes to a LinearGradientBrush after the first two seconds of the animation. -->
                    <DiscreteObjectKeyFrame KeyTime="0:0:2">
                        <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>

                    <!-- After the third second of the animation, the Fill property is suddenly changed 
                to a different LinearGradientBrush which remains until the end of the animation 
                (4 seconds total). -->
                    <DiscreteObjectKeyFrame KeyTime="0:0:3">
                        <DiscreteObjectKeyFrame.Value>
                            <LinearGradientBrush>
                                <LinearGradientBrush.GradientStops>
                                    <GradientStop Color="White" Offset="0.0" />
                                    <GradientStop Color="MediumBlue" Offset="0.5" />
                                    <GradientStop Color="Black" Offset="1.0" />
                                </LinearGradientBrush.GradientStops>
                            </LinearGradientBrush>
                        </DiscreteObjectKeyFrame.Value>
                    </DiscreteObjectKeyFrame>

                </ObjectAnimationUsingKeyFrames.KeyFrames>
            </ObjectAnimationUsingKeyFrames>
        </Storyboard>
    </StackPanel.Resources>

    <!-- The Fill property of this rectangle is animated. -->
    <Rectangle x:Name="animatedRectangle" Loaded="Rectangle_Loaded" Width="300" Height="300" />

</StackPanel>



// When the rectangle loads, begin the animation.
private void Rectangle_Loaded(object sender, RoutedEventArgs e)
{
    myStoryboard.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
Timeline
ObjectKeyFrame

 

 

Afficher:
© 2017 Microsoft