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

DoubleAnimation Class

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

Héritage

Object
  DependencyObject
    Timeline
      DoubleAnimation

Syntaxe


public sealed class DoubleAnimation : Timeline

Attributs

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

Membres

DoubleAnimationClasse possède ces types de membres :

Constructeurs

DoubleAnimationClasse possède ces constructeurs.

ConstructeurDescription
DoubleAnimation Initializes a new instance of the DoubleAnimation class.

 

Événements

DoubleAnimationClasse possède ces événements.

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

 

Méthodes

The DoubleAnimation 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 DoubleAnimationClasse 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 applied to this 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 DoubleAnimation pour animer la valeur de propriété de toute propriété de dépendance qui est de type Double.

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 le composant X du RenderTransform d'un UIElement, vous devez référencer certaines des valeurs de propriété de l'objet intermédiaire, jusqu'à ce que la dernière étape du chemin de propriété indirect soit réellement une valeur Double, comme c'est le cas avec TranslateTransform.X. La chaîne correcte à utiliser pour Storyboard.TargetProperty dans cet exemple est "(UIElement.RenderTransform). (TranslateTransform.X)". 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.

DoubleAnimation 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.

Vous ne pouvez pas animer les valeurs X et Y d'un Point à l'aide d'une classe DoubleAnimation, car ces propriétés ne sont pas des propriétés de dépendance (Point est une structure et ne peut pas avoir de propriétés de dépendance.) À la place, utilisez PointAnimation pour animer les propriétés de dépendance qui ont une valeur Point.

Vous ne pouvez pas utiliser DoubleAnimation pour animer les valeurs int ou byte. À la place, vous devrez utiliser ObjectAnimationUsingKeyFrames, qui ne présente pas le comportement d'interpolation. Vous devrez donc peut-être définir plusieurs images clés pour obtenir une animation relativement fluide. Peu de propriétés de dépendance relatives à l'interface utilisateur utilisent les valeurs int ou les valeurs byte ; aussi cela ne devrait pas être un scénario courant mis à part pour les propriétés personnalisées.

Les propriétés From, By ou ToDoubleAnimation ne sont pas strictement une valeur Double. Au lieu de cela, il s'agit d'un objet Nullable pour Double. La valeur par défaut de ces propriétés est null, et non 0. 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 DoubleAnimation pour créer un rectangle qui s'affiche ou disparaît progressivement une fois chargé.


<StackPanel>
    <StackPanel.Resources>
        <Storyboard x:Name="myStoryboard">
            <DoubleAnimation
          Storyboard.TargetName="MyAnimatedRectangle"
          Storyboard.TargetProperty="Opacity"
          From="1.0" To="0.0" Duration="0:0:3"
          AutoReverse="True" RepeatBehavior="Forever" />
        </Storyboard>
    </StackPanel.Resources>

    <Rectangle Loaded="Start_Animation" x:Name="MyAnimatedRectangle"
     Width="100" Height="100" Fill="Blue" />

</StackPanel>



// 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
DoubleAnimationUsingKeyFrames
Double

 

 

Afficher:
© 2016 Microsoft