Packagefl.motion
Classepublic class Animator
HéritageAnimator Inheritance EventDispatcher Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

La classe Animator applique la description XML d'une interpolation de mouvement à un objet d'affichage. Les propriétés et les méthodes de la classe Animator contrôlent la lecture du mouvement tandis que Flash Player diffuse des événements en réponse aux modifications survenues dans l'état du mouvement. La classe Animator est essentiellement utilisée par le biais de la commande de copie du mouvement en code ActionScript dans Flash CS3. Vous pouvez ensuite modifier le langage ActionScript au moyen de l'API (Application Programming Interface), ou construire votre propre animation personnalisée.

Si vous envisagez d'appeler des méthodes de la classe Animator dans une fonction, déclarez l'occurrence d'Animator hors de la fonction de sorte que le domaine de l'objet ne soit pas limité à la fonction elle-même. Si vous déclarez l'occurrence Animator dans une fonction, Flash Player la supprime à la fin de la fonction au court de sa routine de nettoyage de la mémoire et l'objet cible ne sera pas animé.

Remarque : Si vous n'utilisez pas Flash CS3 pour compiler votre fichier SWF, vous aurez besoin, au moment de la compilation, des classes fl.motion dans votre chemin de classe pour appliquer le mouvement à l'objet d'affichage.

Propriété MXML par défautmotion

Voir aussi

El&eacut;ments XML de mouvement


Propriétés publiques
 PropriétéDéfini par
  autoRewind : Boolean = false
Règle l'animation pour qu'elle redémarre une fois terminée.
Animator
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  isPlaying : Boolean
[lecture-seule] Indique si l’animation est en cours de lecture.
Animator
  motion : Motion
Objet contenant les propriétés d'interpolation de mouvement pour l'animation.
Animator
  orientToPath : Boolean = false
Définit la position de l'objet d'affichage sur la trajectoire de mouvement.
Animator
  positionMatrix : Matrix
Objet Matrix appliquant une transformation globale à la trajectoire de mouvement.
Animator
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  repeatCount : int = 1
Nombre de fois que l'animation doit être répétée.
Animator
  target : DisplayObject
Objet d'affichage actuellement animé.
Animator
  time : int
Entier (commençant à zéro) qui indique et contrôle le temps dans l'animation en cours.
Animator
  transformationPoint : Point
Point de référence pour la rotation ou le redimensionnement d'un objet d'affichage.
Animator
Méthodes publiques
 MéthodeDéfini par
  
Animator(xml:XML = null, target:DisplayObject = null)
Crée un objet Animator pour appliquer la description XML d'une interpolation de mouvement à un objet d'affichage.
Animator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.
EventDispatcher
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
  
end():void
Arrête l'animation tandis que Flash Player passe immédiatement à la dernière image de la séquence d'animation.
Animator
  
fromXMLString(xmlString:String, target:DisplayObject = null):Animator
[static] Crée un objet Animator à partir d'une chaîne XML.
Animator
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 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
  
Avance Flash Player à l'image suivante dans la séquence d'animation.
Animator
  
Interrompt momentanément l'animation jusqu'à ce que la méthode resume() soit appelée.
Animator
  
Commence l'animation.
Animator
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
  
Reprend l'animation après une interruption demandée par la méthode pause().
Animator
  
Positionne Flash Player sur la première image de l'animation.
Animator
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
  
Arrête l'animation tandis que Flash Player revient à la première image dans la séquence d'animation.
Animator
 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
 Inherited
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.
EventDispatcher
Evénements
 Evénement Synthèse Défini par
 Inherited Distribué lorsque Flash Player a le focus du système d’exploitation et devient actif.EventDispatcher
 Inherited Distribué lorsque Flash Player perd le focus du système d’exploitation et devient inactif.EventDispatcher
   Distribué lorsque le mouvement s'arrête, soit parce qu'il est arrivé à son terme, soit parce qu'il a été interrompu par un appel des méthodes stop() ou end().Animator
   Diffusé lorsque le mouvement commence.Animator
   Diffusé lorsque le mouvement a changé et que l'écran a été actualisé.Animator
   Distribué lorsque la valeur time d'Animator a changé, mais que l'écran n'a pas encore été actualisé (événement motionUpdate).Animator
Détails des propriétés
autoRewindpropriété
public var autoRewind:Boolean = false

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Règle l'animation pour qu'elle redémarre une fois terminée.

isPlayingpropriété 
isPlaying:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Indique si l’animation est en cours de lecture.


Implémentation
    public function get isPlaying():Boolean
motionpropriété 
motion:Motion  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Objet contenant les propriétés d'interpolation de mouvement pour l'animation.


Implémentation
    public function get motion():Motion
    public function set motion(value:Motion):void
orientToPathpropriété 
public var orientToPath:Boolean = false

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Définit la position de l'objet d'affichage sur la trajectoire de mouvement. Si elle est définie sur true la ligne de base de l'objet d'affichage s'oriente par rapport à la trajectoire de mouvement ; sinon c'est le point d'alignement qui s'oriente par rapport à cette trajectoire.

positionMatrixpropriété 
public var positionMatrix:Matrix

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Objet Matrix appliquant une transformation globale à la trajectoire de mouvement. Cette matrice permet à la trajectoire d'être déplacée, redimensionnée, inclinée ou pivotée sans modifier l'apparence de l'objet d'affichage.

repeatCountpropriété 
public var repeatCount:int = 1

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Nombre de fois que l'animation doit être répétée. Les valeurs possibles sont tout entier supérieur ou égal à 0. La valeur 1 signifie que l'animation doit être lue une fois. La valeur 0 indique que l'animation est jouée en continu jusqu'à ce qu'elle soit explicitement arrêtée (par un appel à la méthode end(), par exemple).

La valeur par défaut est 1.

Voir aussi

targetpropriété 
target:DisplayObject  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Objet d'affichage actuellement animé. Toute sous-classe de flash.display.DisplayObject est utilisable, telle que MovieClip, Sprite ou Bitmap.


Implémentation
    public function get target():DisplayObject
    public function set target(value:DisplayObject):void

Voir aussi

timepropriété 
time:int  [lecture-écriture]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Entier (commençant à zéro) qui indique et contrôle le temps dans l'animation en cours. 0 est la valeur de time à la première image de l'animation. Si la durée de l'animation est de 10 images, à la dernière image la valeur de time sera 9.


Implémentation
    public function get time():int
    public function set time(value:int):void
transformationPointpropriété 
public var transformationPoint:Point

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Point de référence pour la rotation ou le redimensionnement d'un objet d'affichage. Le point de transformation varie en fonction du cadre de délimitation de l'objet d'affichage. Les coordonnées du point doivent être redimensionnées sur une zone de 1 px x 1 px, sachant que (1, 1) représente le coin inférieur droit de l'objet et (0, 0), le coin supérieur gauche.

Détails du constructeur
Animator()Constructeur
public function Animator(xml:XML = null, target:DisplayObject = null)

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Crée un objet Animator pour appliquer la description XML d'une interpolation de mouvement à un objet d'affichage.

Paramètres
xml:XML (default = null) — Objet E4X contenant une description XML d'interpolation de mouvement.
 
target:DisplayObject (default = null) — Objet d'affichage utilisant l'interpolation de mouvement.

Voir aussi

Détails des méthodes
end()méthode
public function end():void

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Arrête l'animation tandis que Flash Player passe immédiatement à la dernière image de la séquence d'animation. Si la propriété autoRewind est définie sur true, Flash Player passe à la première image dans la séquence d'animation.

Voir aussi

fromXMLString()méthode 
public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Crée un objet Animator à partir d'une chaîne XML. Cette méthode se présente comme une alternative à l'utilisation du constructeur Animator qui accepte un objet E4X à la place.

Paramètres

xmlString:String — Chaîne de code XML décrivant l'interpolation de mouvement.
 
target:DisplayObject (default = null) — Objet d'affichage utilisant l'interpolation de mouvement.

Valeur renvoyée
Animator — Occurrence Animator appliquant le paramètre xmlString spécifié au paramètre target indiqué.

Voir aussi

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Avance Flash Player à l'image suivante dans la séquence d'animation.

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Interrompt momentanément l'animation jusqu'à un appel de la méthode resume().

Voir aussi

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Commence l'animation. Appelez la méthode end() avant d'appeler la méthode play() pour vous assurer que toute précédente occurrence de l'animation est terminée avant d'en commencer une nouvelle.

Voir aussi

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Reprend l'animation après une interruption demandée par la méthode pause().

Voir aussi

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Positionne Flash Player sur la première image de l'animation. Si l'animation était en cours de lecture, elle est poursuivie à partir de la première image. Si l'animation était arrêtée, elle est maintenue à l'arrêt sur la première image.

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

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Arrête l'animation tandis que Flash Player revient à la première image dans la séquence d'animation.

Voir aussi

Détails des événements
motionEnd Evénement
Type d'objet événement: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_END

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué lorsque le mouvement s'arrête, soit parce qu'il est arrivé à son terme, soit parce qu'il a été interrompu par un appel des méthodes stop() ou end().

Indique que le mouvement s'est arrêté, soit par un appel explicite à Animator.stop() ou Animator.end(), soit parce qu'il est arrivé à son terme.

Les propriétés de l'objet de l'événement sont les valeurs suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse
currentTargetObjet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que currentTarget.
targetObjet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget.
motionStart Evénement  
Type d'objet événement: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_START

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Diffusé lorsque le mouvement commence.

Indique que la lecture de l'occurrence de Motion a commencé.

Les propriétés de l'objet de l'événement sont les valeurs suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse
currentTargetObjet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que currentTarget.
targetObjet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget.
motionUpdate Evénement  
Type d'objet événement: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.MOTION_UPDATE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Diffusé lorsque le mouvement a changé et que l'écran a été actualisé.

Indique que l'occurrence de Motion a changé et que l'écran a été actualisé.

Les propriétés de l'objet de l'événement sont les valeurs suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse
currentTargetObjet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que currentTarget.
targetObjet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget.
timeChange Evénement  
Type d'objet événement: fl.motion.MotionEvent
MotionEvent.type property = fl.motion.MotionEvent.TIME_CHANGE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9.0.28.0

Distribué lorsque la valeur time d'Animator a changé, mais que l'écran n'a pas encore été actualisé (événement motionUpdate).

Indique que la valeur time de l'occurrence d'Animator a changé, mais que l'écran n'a pas encore été actualisé (Flash Player n'a pas diffusé l'événement motionUpdate).

Les propriétés de l'objet de l'événement sont les valeurs suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse
currentTargetObjet qui définit l'écouteur qui gère cet événement. Par exemple, si vous utilisez myButton.addEventListener() pour enregistrer un écouteur d'événement, myButton a la même valeur que currentTarget.
targetObjet qui a diffusé l'événement (ce n'est pas toujours celui qui écoute l'événement). Pour accéder systématiquement à l'objet qui écoute l'événement, utilisez la propriété currentTarget.




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/fl/motion/Animator.html