PointAnimation Class

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

Héritage

Object
  DependencyObject
    Timeline
      PointAnimation

Syntaxe


public sealed class PointAnimation : Timeline

Attributs

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

Membres

PointAnimationClasse possède ces types de membres :

Constructeurs

PointAnimationClasse possède ces constructeurs.

ConstructeurDescription
PointAnimation Initializes a new instance of the PointAnimation class.

 

Événements

PointAnimationClasse possède ces événements.

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

 

Méthodes

The PointAnimation 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 PointAnimationClasse 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)

By

Lecture/écritureGets or sets the total amount by which the animation changes its starting value.

ByProperty

En lecture seuleIdentifies the By dependency property.

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)

EasingFunction

Lecture/écritureGets or sets the easing function you are applying to the animation.

EasingFunctionProperty

En lecture seuleIdentifies the EasingFunction dependency property.

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)

From

Lecture/écritureGets or sets the animation's starting value.

FromProperty

En lecture seuleIdentifies the From dependency property.

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)

To

Lecture/écritureGets or sets the animation's ending value.

ToProperty

En lecture seuleIdentifies the To dependency property.

 

Remarques

Utilisez PointAnimation pour animer la valeur de propriété de toute propriété de dépendance qui est de type Point.

L'interpolation linéaire d'un Point signifie que les valeurs X et Y sont traitées comme un nombre et que l'interpolation est une simple opération mathématique.

Quelquefois, vous devrez utiliser le ciblage de propriété indirect afin de cibler une sous-propriété d'un autre objet étant la valeur d'une propriété sur la cible. Par exemple, pour animer des parties d'un PathGeometry, vous devez référencer certaines des valeurs de propriété de l'objet intermédiaires, jusqu'à ce que la dernière étape du chemin de propriété indirect soit réellement une valeur Point. Pour plus d'informations sur le ciblage indirect de propriété et autres concepts de l'animation avec plan conceptuel, consultez Animations avec plan conceptuel ou PropertyPath, syntaxe.

PointAnimation a généralement au moins l'une des propriétés From, By ou To définies, mais jamais les trois.

  • From uniquement : l'animation passe de la valeur spécifiée par la propriété From à la valeur de base de la propriété en cours d'animation.
  • 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 uniquement : 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 uniquement : 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.

Les propriétés From, By ou ToPointAnimation ne sont pas une valeur Point. Au lieu de cela, il s'agit d'un objet Nullable pour Point. La valeur par défaut de ces membres est null, pas une structure non initialisée. Cette valeur null concerne la façon dont le système d'animation distingue que vous n'avez pas défini spécifiquement une valeur. Les extensions de composants Visual C++ (C++/CX) n'ont pas de type Nullable. Elles utilisent ainsi IReference à la place.

Exemples

L'exemple suivant montre comment utiliser PointAnimation pour animer la propriété Center d'un élément EllipseGeometry.


<Canvas Width="450" Height="350">
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the center point of the ellipse from 100 X, 300 Y
             to 400 X, 100 Y over 5 seconds. -->
            <PointAnimation
             Storyboard.TargetProperty="Center"
             Storyboard.TargetName="MyAnimatedEllipseGeometry"
             Duration="0:0:5" 
             From="100,300"
             To="400,100"
             RepeatBehavior="Forever" EnableDependentAnimation="True"/>

        </Storyboard>
    </Canvas.Resources>
    <Path Fill="Blue" Loaded="Start_Animation">
        <Path.Data>

            <!-- Describes an ellipse. -->
            <EllipseGeometry x:Name="MyAnimatedEllipseGeometry"
             Center="200,100" RadiusX="15" RadiusY="15" />
        </Path.Data>
    </Path>
</Canvas>



// Start the animation when the object loads
private void Start_Animation(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
XAML, exemple d'animation
Timeline
Point
PointAnimationUsingKeyFrames

 

 

Afficher:
© 2014 Microsoft