Packagefl.transitions
Classepublic class Tween
HéritageTween Inheritance EventDispatcher Inheritance Object

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

La classe Tween vous permet, à l'aide d'ActionScript, de déplacer et de redimensionner les clips sur la scène et d'en réaliser un fondu, en définissant une propriété du clip cible afin qu'il soit animé sur un certain nombre d'images ou de secondes.

Cette classe vous permet également de spécifier de nombreuses méthodes d'accélération. Ce terme fait ici référence à une accélération ou une décélération progressive survenant pendant l'animation et destinée à améliorer son réalisme. Le package fl.transitions.easing fournit de nombreuses méthodes contenant des équations correspondant à cette accélération et à cette décélération, qui modifient l'animation d'accélération en conséquence.

Pour utiliser les méthodes et les propriétés de la classe Tween, vous utilisez l'opérateur new avec la fonction constructeur pour créer une occurrence de la classe et vous spécifiez une méthode d'accélération sous forme de paramètre. Exemple :

 import fl.transitions.Tween;
 import fl.transitions.easing.*;
 var myTween:Tween = new Tween(myObject, "x", Elastic.easeOut, 0, 300, 3, true);
 

Voir aussi

fl.transitions.TransitionManager
fl.transitions.easing
Tween()


Propriétés publiques
 PropriétéDéfini par
  begin : Number = NaN
Valeur initiale de la propriété désignée de l'objet cible avant le démarrage de l'interpolation.
Tween
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
  duration : Number
La durée de l'animation interpolée en images ou en secondes.
Tween
  finish : Number
Nombre indiquant la valeur de fin de la propriété de l'objet cible à interpoler.
Tween
  FPS : Number
Nombre d'images par seconde calculé dans l'animation interpolée.
Tween
  func : Function
Fonction d'accélération utilisée avec l'interpolation.
Tween
  isPlaying : Boolean = false
Indique si l'animation interpolée est en cours de lecture.
Tween
  looping : Boolean = false
Indique si l'interpolation doit être exécutée en boucle.
Tween
  obj : Object = null
Objet cible auquel est appliquée l'interpolation.
Tween
  position : Number
Valeur actuelle de la propriété de l'objet cible en cours d'interpolation.
Tween
  prop : String = ""
Nom de la propriété affectée par l'interpolation de l'objet cible.
Tween
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  time : Number
L'heure actuelle dans la durée de l'animation.
Tween
  useSeconds : Boolean = false
Indique si la durée de l'interpolation est définie en images ou en secondes.
Tween
Méthodes publiques
 MéthodeDéfini par
  
Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)
Crée une occurrence de la classe Tween.
Tween
 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
  
continueTo(finish:Number, duration:Number):void
Indique à l'animation interpolée de poursuivre l'interpolation de son point d'animation actuel à un nouveau point de durée et de fin.
Tween
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
  
Transmet l'animation interpolée directement à la valeur finale de l'animation interpolée.
Tween
 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
  
Transmet l'animation interpolée à la prochaine image d'une animation arrêtée.
Tween
  
Lit l'image précédente de l'animation interpolée depuis le point d'arrêt actuel d'une animation qui a été arrêtée.
Tween
 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 la lecture d'une animation interpolée arrêtée.
Tween
  
rewind(t:Number = 0):void
Recule la lecture d'une animation interpolée jusqu'à sa valeur de début.
Tween
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
  
Démarre la lecture d'une animation interpolée depuis son point de départ.
Tween
  
Arrête la lecture d'une animation interpolée à sa valeur actuelle.
Tween
 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
  
Indique à l'animation interpolée d'effectuer la lecture à l'envers en partant de la dernière direction des incréments de propriété interpolés.
Tween
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
   Indique que l'interpolation a changé et que l'écran a été actualisé.Tween
   Indique que l'interpolation a atteint sa fin et a terminé.Tween
   Indique que la lecture de l'interpolation a repris depuis le début en mode boucle.Tween
   Indique que la lecture de l'interpolation a repris après une pause.Tween
   Indique que la lecture du mouvement a commencé.Tween
   Indique que l'objet Tween a été interrompu par un appel explicite de Tween.stop().Tween
Détails des propriétés
beginpropriété
public var begin:Number = NaN

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

Valeur initiale de la propriété désignée de l'objet cible avant le démarrage de l'interpolation.

durationpropriété 
duration:Number  [lecture-écriture]

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

La durée de l'animation interpolée en images ou en secondes. Cette propriété est définie comme un paramètre lors de la création d'une occurrence Tween ou de l'appel à la méthode Tween.yoyo().


Implémentation
    public function get duration():Number
    public function set duration(value:Number):void
finishpropriété 
finish:Number  [lecture-écriture]

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

Nombre indiquant la valeur de fin de la propriété de l'objet cible à interpoler. Cette propriété est définie sous forme de paramètre lors de la création d'une occurrence Tween ou de l'appel à la méthode Tween.yoyo().


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

Voir aussi

FPSpropriété 
FPS:Number  [lecture-écriture]

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

Nombre d'images par seconde calculé dans l'animation interpolée. Par défaut, la fréquence d'images actuelle de la scène est utilisée pour calculer l'animation interpolée. Définir cette propriété permet de recalculer le nombre d'incréments dans la propriété animée, qui est affichée à chaque seconde sur la propriété Tween.FPS plutôt que sur la fréquence d'images actuelle de la scène. La définition de la propriété Tween.FPS ne modifie pas la fréquence d'images effective de la scène.

Remarque :La propriété Tween.FPS renvoie undefined, à moins que vous ne l'ayez déjà définie de façon explicite.


Implémentation
    public function get FPS():Number
    public function set FPS(value:Number):void
funcpropriété 
public var func:Function

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

Fonction d'accélération utilisée avec l'interpolation.

isPlayingpropriété 
public var isPlaying:Boolean = false

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

Indique si l'animation interpolée est en cours de lecture.

loopingpropriété 
public var looping:Boolean = false

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

Indique si l'interpolation doit être exécutée en boucle. Si la valeur est true, l'interpolation redémarre indéfiniment chaque fois qu'elle se termine. Si la valeur est false, l'interpolation n'est lue qu'une fois.

objpropriété 
public var obj:Object = null

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

Objet cible auquel est appliquée l'interpolation.

positionpropriété 
position:Number  [lecture-écriture]

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

Valeur actuelle de la propriété de l'objet cible en cours d'interpolation. Cette valeur est mise à jour avec chaque image dessinée de l'animation interpolée.


Implémentation
    public function get position():Number
    public function set position(value:Number):void
proppropriété 
public var prop:String = ""

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

Nom de la propriété affectée par l'interpolation de l'objet cible.

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

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

L'heure actuelle dans la durée de l'animation.


Implémentation
    public function get time():Number
    public function set time(value:Number):void
useSecondspropriété 
public var useSeconds:Boolean = false

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

Indique si la durée de l'interpolation est définie en images ou en secondes. La valeur true entraîne l'animation de l'interpolation pendant un nombre de secondes spécifié dans la propriété duration. La valeur false entraîne l'animation de l'interpolation pendant un nombre d'images.

Détails du constructeur
Tween()Constructeur
public function Tween(obj:Object, prop:String, func:Function, begin:Number, finish:Number, duration:Number, useSeconds:Boolean = false)

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

Crée une occurrence de la classe Tween. Utilisez la fonction constructeur avec l'opérateur new : var myTween:Tween = new Tween().

Paramètres
obj:Object — Objet cible de l'interpolation.
 
prop:String — Nom de la propriété (valeur de paramètre obj) qui sera affectée.
 
func:Function — Nom de la fonction d'accélération à utiliser.
 
begin:Number — Valeur de départ du paramètre prop.
 
finish:Number — Nombre indiquant la valeur de fin du paramètre prop (propriété de l'objet cible à interpoler).
 
duration:Number — Durée du mouvement ; défini sur infinity si négatif ou omis.
 
useSeconds:Boolean (default = false) — Indicateur spécifiant l'utilisation de secondes au lieu d'images. La fonction utilise des secondes si la valeur est true ou des images selon la valeur spécifiée dans le paramètre duration si la valeur est false.

Voir aussi

Détails des méthodes
continueTo()méthode
public function continueTo(finish:Number, duration:Number):void

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

Indique à l'animation interpolée de poursuivre l'interpolation de son point d'animation actuel à un nouveau point de durée et de fin.

Paramètres

finish:Number — Nombre indiquant la valeur de fin de la propriété de l'objet cible à interpoler.
 
duration:Number — Nombre indiquant la durée ou le nombre d'images pour le mouvement d'interpolation ; la durée est mesurée en secondes si le paramètre Tween.start() useSeconds est défini sur true ou en images s'il est défini sur false.

Voir aussi

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

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

Transmet l'animation interpolée directement à la valeur finale de l'animation interpolée.

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

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

Transmet l'animation interpolée à la prochaine image d'une animation arrêtée. Utilisez cette méthode pour transmettre une image à la fois d'une animation interpolée après avoir utilisé la méthode Tween.stop() pour l'arrêter.

Remarque : N'utilisez cette méthode que pour les interpolations à base d'images. Une interpolation est définie à base d'images lors de sa création en définissant le paramètre useSeconds sur false.

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

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

Lit l'image précédente de l'animation interpolée depuis le point d'arrêt actuel d'une animation qui a été arrêtée. Utilisez cette méthode pour lire une animation interpolée en arrière d'une image à la fois après l'avoir arrêtée à l'aide de la méthode Tween.stop().

Remarque : N'utilisez cette méthode que pour les interpolations à base d'images. Une interpolation est définie à base d'images lors de sa création en définissant le paramètre Tween.start() useSeconds sur false.

Voir aussi

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

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

Reprend la lecture d'une animation interpolée arrêtée. Utilisez cette méthode pour poursuivre une animation interpolée après son arrêt à l'aide de la méthode Tween.stop().

Remarque : N'utilisez cette méthode que pour les interpolations à base d'images. Une interpolation est définie à base d'images lors de sa création en définissant le paramètre useSeconds sur false.

rewind()méthode 
public function rewind(t:Number = 0):void

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

Recule la lecture d'une animation interpolée jusqu'à sa valeur de début. Si la méthode Tween.rewind() est appelée pendant la lecture de l'animation interpolée, l'animation est rembobinée jusqu'à sa valeur de début et poursuit la lecture. Si la méthode Tween.rewind() est appelée alors que l'animation interpolée est arrêtée ou a terminé son animation, l'animation interpolée est rembobinée jusqu'à sa valeur de début, et reste arrêtée. Utilisez cette méthode pour rembobiner une animation interpolée à son point de départ une fois que vous l'avez arrêtée en utilisant la méthode Tween.stop() ou pour rembobiner une animation interpolée pendant sa lecture.

Paramètres

t:Number (default = 0) — Valeur de début.

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

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

Démarre la lecture d'une animation interpolée depuis son point de départ. Cette méthode permet de redémarrer une interpolation depuis le début de son animation après son arrêt ou la fin de son animation.

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

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

Arrête la lecture d'une animation interpolée à sa valeur actuelle.

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

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

Indique à l'animation interpolée d'effectuer la lecture à l'envers en partant de la dernière direction des incréments de propriété interpolés. Si cette méthode est appelée avant la fin de l'animation d'un objet Tween, l'animation passe directement à la fin de sa lecture, puis lit dans la direction inverse à partir de ce point. Si vous appelez la méthode Tween.yoyo() dans un gestionnaire d'événements TweenEvent.MOTION_FINISH, vous pouvez obtenir un effet d'animation qui termine sa lecture, puis inverse toute sa lecture. Cette procédure garantit que l'effet inverse de la méthode Tween.yoyo() ne commence pas tant que l'actuelle animation interpolée n'est pas terminée.

Détails des événements
motionChange Evénement
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_CHANGE

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

Indique que l'interpolation 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 la propriété 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.
timeDurée de l'interpolation au moment de l'événement.
positionValeur de la propriété contrôlée par l'interpolation, au moment de l'événement.
motionFinish Evénement  
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_FINISH

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

Indique que l'interpolation a atteint sa fin et a terminé.

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 la propriété 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.
timeDurée de l'interpolation au moment de l'événement.
positionValeur de la propriété contrôlée par l'interpolation, au moment de l'événement.
motionLoop Evénement  
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_LOOP

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

Indique que la lecture de l'interpolation a repris depuis le début en mode boucle.

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 la propriété 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.
timeDurée de l'interpolation au moment de l'événement.
positionValeur de la propriété contrôlée par l'interpolation, au moment de l'événement.
motionResume Evénement  
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_RESUME

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

Indique que la lecture de l'interpolation a repris après une pause.

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 la propriété 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.
timeDurée de l'interpolation au moment de l'événement.
positionValeur de la propriété contrôlée par l'interpolation, au moment de l'événement.
motionStart Evénement  
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_START

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

Indique que la lecture du mouvement 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 la propriété 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.
timeDurée de l'interpolation au moment de l'événement.
positionValeur de la propriété contrôlée par l'interpolation, au moment de l'événement.
motionStop Evénement  
Type d'objet événement: fl.transitions.TweenEvent
TweenEvent.type property = fl.transitions.TweenEvent.MOTION_STOP

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

Indique que l'interpolation a été interrompue par un appel explicite de Tween.stop().

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 la propriété 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.
timeDurée de l'interpolation au moment de l'événement.
positionValeur de la propriété contrôlée par l'interpolation, au moment de l'événement.




 

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/transitions/Tween.html