Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
spark.effects.animation 

Animation  - AS3 Flex

Packagespark.effects.animation
Classepublic final class Animation
HéritageAnimation Inheritance Object

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

La classe Animation définit une animation qui se déroule entre les valeurs de début et de fin d’une propriété sur une période donnée. L’animation peut correspondre à un changement de position (effet Move, par exemple), un changement de taille (effet Resize), un changement de visibilité (effet Fade) ou à d’autres types d’animations réalisées par des effets ou exécutées directement par le biais de la classe Animation.

Cette classe définit la durée et les valeurs de l’animation. D’autres séquences de code, définies dans le code des effets ou de l’application, associent l’animation à des objets et des propriétés cible. Les valeurs d’animation produites par la classe Animation peuvent ainsi être appliquées à des objets et propriétés cible pour permettre l’animation de ces objets.

Pour définir des effets d’animation, la procédure normale consiste à créer une instance de la classe Animate ou une sous-classe d’Animate. Ainsi, vous créez une instance Animation dans la méthode play(). L’instance Animation accepte des valeurs de début, de fin, de durée, ainsi que des paramètres facultatifs, par exemple des objets d’accélération et d’interpolation.

L’objet Animation appelle des écouteurs d’événement au début et à la fin de l’animation, lorsque l’animation est répétée, mais aussi à intervalle régulier tout au long de l’animation. Ces appels transmettent des valeurs calculées par l’instance Animation à partir des valeurs de début et de fin et des objets d’accélération et d’interpolation. Ces valeurs peuvent ensuite être utilisées pour définir les valeurs des propriétés sur les objets cible.

Propriété MXML par défautmotionPaths

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  animationTarget : spark.effects.animation:IAnimationTarget
Objet IAnimationTarget devant recevoir une notification pour tous les événements de début, de fin, de répétition et de mise à jour de cette animation.
Animation
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  currentValue : Object
Objet contenant les valeurs calculées correspondant à l’image en cours de l’animation.
Animation
  cycleFraction : Number
[lecture seule] La fraction en cours écoulée dans l’animation, après que l’accélération a été appliquée.
Animation
  cycleTime : Number
[lecture seule] La position en millisecondes actuelle dans le cycle d’animation en cours.
Animation
  duration : Number = 500
Durée de l’animation, en millisecondes, sans compter les répétitions définies par la propriété repeatCount.
Animation
  easer : IEaser
Comportement d’accélération de cet effet.
Animation
  interpolator : IInterpolator = null
Interpolateur utilisé par l’instance Animation pour calculer les valeurs situées entre les valeurs de début et de fin de la propriété.
Animation
  isPlaying : Boolean
[lecture seule] Si la valeur est true, l’animation est en cours de lecture.
Animation
  motionPaths : Vector.<MotionPath>
Jeu d’objets MotionPath définissant les propriétés et valeurs qui font l’objet d’une animation.
Animation
  playheadTime : Number
Temps écoulé depuis le début de l’animation, en incluant le délai d’attente et les répétitions.
Animation
  playReversed : Boolean
Si la valeur est true, l’animation est lue à l’envers.
Animation
  repeatBehavior : String
Définit le comportement d’une animation répétée.
Animation
  repeatCount : int
Nombre de répétitions de cette animation.
Animation
  repeatDelay : Number
Délai d’attente, en millisecondes, avant le début de chaque cycle de répétition.
Animation
  startDelay : Number
Délai d’attente avant le début de l’animation.
Animation
Méthodes publiques
 MéthodeDéfini par
  
Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Constructeur.
Animation
  
Interrompt l’animation, atteint immédiatement la fin de l’animation, et appelle la fonction animationEnd() sur la cible animationTarget.
Animation
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.
Object
  
Suspend l’effet jusqu’à ce que la méthode resume() soit appelée.
Animation
  
Démarre l’animation.
Animation
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Reprend l’effet après une interruption demandée par un appel de la méthode pause().
Animation
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
  
Arrête l’animation et la termine sans appeler la méthode end().
Animation
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

animationTarget

propriété
animationTarget:spark.effects.animation:IAnimationTarget

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Objet IAnimationTarget devant recevoir une notification pour tous les événements de début, de fin, de répétition et de mise à jour de cette animation. La valeur null indique qu’il n’y a pas de cible à notifier.

La valeur par défaut est null.



Implémentation
    public function get animationTarget():spark.effects.animation:IAnimationTarget
    public function set animationTarget(value:spark.effects.animation:IAnimationTarget):void

currentValue

propriété 
public var currentValue:Object

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Objet contenant les valeurs calculées correspondant à l’image en cours de l’animation. Les valeurs sont stockées sous forme de valeurs de mappage, en utilisant comme clé les noms de propriété.

cycleFraction

propriété 
cycleFraction:Number  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

La fraction en cours écoulée dans l’animation, après que l’accélération a été appliquée. Cette valeur est comprise entre 0 et 1. Un « cycle » d’animation est défini comme une seule répétition de l’animation, où la propriété repeatCount définit le nombre de cycles qui seront exécutés.



Implémentation
    public function get cycleFraction():Number

cycleTime

propriété 
cycleTime:Number  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

La position en millisecondes actuelle dans le cycle d’animation en cours. Cette valeur est comprise entre 0 et duration. Un « cycle » d’animation est défini comme une seule répétition de l’animation, où la propriété repeatCount définit le nombre de cycles qui seront exécutés. Utilisez la méthode seek() pour modifier la position de l’animation.



Implémentation
    public function get cycleTime():Number

duration

propriété 
public var duration:Number = 500

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Durée de l’animation, en millisecondes, sans compter les répétitions définies par la propriété repeatCount.

La valeur par défaut est 500.

easer

propriété 
easer:IEaser

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Comportement d’accélération de cet effet. Cet objet IEaser est utilisé pour convertir la partie écoulée de l’animation en partie accélérée, qui est ensuite utilisée pour calculer la valeur au niveau de cette fraction écoulée accélérée.

La valeur null signifie qu’aucune accélération n’est mise en œuvre, ce qui revient à utiliser une accélération Linear ou animation.easer = Linear.getInstance();.

La valeur par défaut est Sine(.5).



Implémentation
    public function get easer():IEaser
    public function set easer(value:IEaser):void

interpolator

propriété 
public var interpolator:IInterpolator = null

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Interpolateur utilisé par l’instance Animation pour calculer les valeurs situées entre les valeurs de début et de fin de la propriété. Par défaut, la classe utilise la classe NumberInterpolator ou, dans les cas où les valeurs de début et de fin sont des tableaux ou des vecteurs, par la classe MultiValueInterpolator. L’interpolation d’autres types de données ou de valeurs Number devant être interpolées de façon différente, par exemple des valeurs uint contenant des informations de canal de couleur, peut être traitée en spécifiant un autre interpolateur.

Eléments de l’API associés

isPlaying

propriété 
isPlaying:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Si la valeur est true, l’animation est en cours de lecture. La valeur est false, sauf si l’animation a été lancée et n’a pas encore été arrêtée (soit par programmation, soit automatiquement) ni suspendue.

La valeur par défaut est false.



Implémentation
    public function get isPlaying():Boolean

motionPaths

propriété 
public var motionPaths:Vector.<MotionPath>

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Jeu d’objets MotionPath définissant les propriétés et valeurs qui font l’objet d’une animation.

Eléments de l’API associés

playheadTime

propriété 
playheadTime:Number

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Temps écoulé depuis le début de l’animation, en incluant le délai d’attente et les répétitions. Pendant le premier cycle d’une animation, cette valeur est égale à celle de cycleTime.



Implémentation
    public function get playheadTime():Number
    public function set playheadTime(value:Number):void

playReversed

propriété 
playReversed:Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Si la valeur est true, l’animation est lue à l’envers. Si l’animation est en cours de lecture dans la direction opposée à la valeur playReversed spécifiée, l’animation change de direction de manière dynamique.

La valeur par défaut est false.



Implémentation
    public function get playReversed():Boolean
    public function set playReversed(value:Boolean):void

repeatBehavior

propriété 
repeatBehavior:String

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Définit le comportement d’une animation répétée. La propriété repeatCount d’une animation répétée est définie sur 0 ou sur une valeur supérieure à 1. Cette valeur doit être soit RepeatBehavior.LOOP, auquel cas l’animation est répétée systématiquement dans le même sens, soit RepeatBehavior.REVERSE, auquel cas l’animation est inversée à chaque répétition.

La valeur par défaut est RepeatBehavior.LOOP.



Implémentation
    public function get repeatBehavior():String
    public function set repeatBehavior(value:String):void

Eléments de l’API associés

repeatCount

propriété 
repeatCount:int

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Nombre de répétitions de cette animation. La valeur 0 signifie qu’elle se répète indéfiniment.

La valeur par défaut est 1.



Implémentation
    public function get repeatCount():int
    public function set repeatCount(value:int):void

repeatDelay

propriété 
repeatDelay:Number

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Délai d’attente, en millisecondes, avant le début de chaque cycle de répétition. Si cette valeur n’est pas nulle, le cycle d’animation précédent s’arrête exactement au niveau de la valeur de fin. Cependant, les répétitions non retardées peuvent ignorer totalement cette valeur, lorsque l’animation passe progressivement d’un point situé peu avant la fin d’un cycle à un point situé peu après le début du cycle suivant. La valeur de cette propriété doit être supérieure ou égale à 0.

Cette propriété est utilisée pour la première répétition après le premier cycle de l’animation. Pour retarder le premier cycle de l’animation, utilisez la propriété startDelay.

La valeur par défaut est 0.



Implémentation
    public function get repeatDelay():Number
    public function set repeatDelay(value:Number):void

Eléments de l’API associés

startDelay

propriété 
startDelay:Number

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Délai d’attente avant le début de l’animation. La valeur de cette propriété doit être supérieure ou égale à 0.

La valeur par défaut est 0.



Implémentation
    public function get startDelay():Number
    public function set startDelay(value:Number):void
Détails du constructeur

Animation

()Constructeur
public function Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Constructeur. Les paramètres facultatifs property, startValue et endValue définissent une animation simple utilisant un seul objet MotionPath et deux images-clés KeyFrame. Si une des valeurs n’est pas null, la valeur startValue devient la valeur value de la première image-clé, à la position temporelle 0, et la valeur endValue devient la valeur value de la deuxième image-clé, à la fin de l’animation.

Paramètres
duration:Number (default = 500) — Durée de l’animation, en millisecondes.
 
property:String (default = null) — Propriété devant faire l’objet d’une animation.
 
startValue:Object (default = null) — Valeur initiale de la propriété.
 
endValue:Object (default = null) — Valeur finale de la propriété.
Détails de la méthode

end

()méthode
public function end():void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Interrompt l’animation, atteint immédiatement la fin de l’animation, et appelle la fonction animationEnd() sur la cible animationTarget.

pause

()méthode 
public function pause():void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Suspend l’effet jusqu’à ce que la méthode resume() soit appelée. Si la méthode stop() est appelée avant la méthode resume(), il est impossible de reprendre l’animation.

play

()méthode 
public function play():void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Démarre l’animation. Si l’animation est déjà en cours, elle est arrêtée puis relancée.

resume

()méthode 
public function resume():void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Reprend l’effet après une interruption demandée par un appel de la méthode pause().

stop

()méthode 
public function stop():void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Arrête l’animation et la termine sans appeler la méthode end(). La fonction animationStop() sur la cible animationTarget sera appelée.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.