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

AnimateInstance  - AS3 Flex

Packagespark.effects.supportClasses
Classepublic class AnimateInstance
HéritageAnimateInstance Inheritance EffectInstance Inheritance EventDispatcher Inheritance Object
Implémente IAnimationTarget
Sous-classes AnimateColorInstance, AnimateFilterInstance, AnimateTransformInstance, AnimateTransitionShaderInstance, FadeInstance, ResizeInstance

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 AnimateInstance implémente la classe d’instance de l’effet Animate. Flex crée une instance de cette classe lorsqu’un effet Animate est exécuté. Vous ne devez pas la créer manuellement.

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 InheritedclassName : String
[lecture seule] Nom de la classe d’effet, tel que « FadeInstance ».
EffectInstance
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  disableLayout : Boolean
Si la valeur est true, l’effet désactive la mise en page des conteneurs parent de ses cibles, définissant la propriété autoLayout des conteneurs sur false, et désactive également toute contrainte de mise en page sur les objets cible.
AnimateInstance
 Inheritedduration : Number
Durée de l’effet, en millisecondes.
EffectInstance
  easer : IEaser
Comportement d’accélération de cet effet.
AnimateInstance
 Inheritedeffect : IEffect
Objet IEffect qui a créé cet objet IEffectInstance.
EffectInstance
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
Propriété qui permet d’accéder au contrôle à base de liste de la cible d’un effet data.
EffectInstance
 InheritedhideFocusRing : Boolean
Détermine si l’effet doit masquer l’anneau de focus lors du démarrage.
EffectInstance
  interpolator : IInterpolator
Interpolateur utilisé par cet effet pour calculer les valeurs situées entre les valeurs de début et de fin d’une propriété.
AnimateInstance
  motionPaths : Vector.<MotionPath>
Un vecteur d’objets MotionPath contenant chacun le nom d’une propriété animée et les valeurs prises par la propriété au cours de l’animation.
AnimateInstance
  playheadTime : Number
[override] Temps de position actuelle de l’effet.
AnimateInstance
 InheritedpropertyChanges : PropertyChanges
Spécifie l’objet PropertyChanges contenant les valeurs de départ et d’arrivée de l’ensemble des propriétés correspondant aux cibles de l’effet.
EffectInstance
  repeatBehavior : String
Comportement d’un effet répété, c’est-à-dire d’un effet dont la valeur repeatCount est égale à 0 ou supérieure à 1.
AnimateInstance
 InheritedrepeatCount : int
Nombre de fois que l’effet doit être répété.
EffectInstance
 InheritedrepeatDelay : int
Intervalle (en millisecondes), qui s’écoule avant de répéter l’effet.
EffectInstance
 InheritedstartDelay : int
Intervalle (en millisecondes), qui s’écoule avant de commencer l’effet.
EffectInstance
 InheritedsuspendBackgroundProcessing : Boolean
Si la valeur est true, elle bloque tout le traitement en arrière-plan pendant l’exécution de l’effet.
EffectInstance
 Inheritedtarget : Object
Objet UIComponent sur lequel cet effet est appliqué.
EffectInstance
 InheritedtriggerEvent : Event
L’événement, le cas échéant, qui a déclenché la lecture de l’effet.
EffectInstance
Propriétés protégées
 PropriétéDéfini par
  autoRemoveTarget : Boolean = false
Si la valeur est true, l’effet conserve sa cible pendant une transition et la supprime une fois la transition terminée.
AnimateInstance
 InheritedplayCount : int = 0
Nombre de fois que l’instance a été exécutée.
EffectInstance
Méthodes publiques
 MéthodeDéfini par
  
Constructeur.
AnimateInstance
 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
 Inherited
Interrompt une instance d’effet en cours de lecture et passe immédiatement à la fin de l’effet.
EffectInstance
 Inherited
Appelée par la méthode end() à la fin de la lecture de l’effet.
EffectInstance
 Inherited
Appelé à la fin de la lecture de chaque itération d’un effet répété.
EffectInstance
 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
Cette méthode est appelée si l’effet a été déclenché par le gestionnaire EffectManager.
EffectInstance
 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
 Inherited
Interrompt momentanément l’effet jusqu’à un appel de la méthode resume().
EffectInstance
 Inherited
Exécute l’instance d’effet sur la cible.
EffectInstance
 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
 Inherited
Reprend l’effet après une interruption demandée par un appel de la méthode pause().
EffectInstance
 Inherited
Exécute l’effet en sens inverse, à partir de sa position actuelle.
EffectInstance
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Exécute l’instance d’effet sur la cible, au terme de la période startDelay.
EffectInstance
 Inherited
Arrête l’effet, en laissant la cible dans son état actuel.
EffectInstance
 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
 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[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
Détails de la propriété

autoRemoveTarget

propriété
protected var autoRemoveTarget:Boolean = false

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’effet conserve sa cible pendant une transition et la supprime une fois la transition terminée. Cette fonction s’applique plus spécifiquement aux effets tels que Fade, qui agissent sur des cibles supprimées à la fin de la transition. Ainsi, il n’est pas nécessaire de spécifier un effet RemoveAction ou un effet similaire pour conserver manuellement l’élément et le supprimer au terme de la transition.

Pour utiliser cette fonction, les sous-classes doivent définir cette variable sur true et exposer la propriété parent dans leur tableau affectedProperties, de sorte que l’instance d’effet dispose des informations suffisantes sur la cible et le conteneur pour réaliser l’opération.

disableLayout

propriété 
public var disableLayout: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’effet désactive la mise en page de son objet parent des cibles aux conteneurs, aux conteneurs la définition de la propriété autoLayout sur false, et désactive également une mise en page contrainte sur les objets cible. Ces propriétés seront restaurées lorsque l’effet se termine.

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.

Remarque : il est possible d’avoir une accélération au niveau de l’effet et au niveau de l’image-clé (où les images-clés contiennent les valeurs/heures utilisées dans les structures d’accélération). Ces comportements d’accélération se construisent les uns sur les autres. Le paramètre easier contrôle l’accélération de l’effet global. Keyframe contrôle l’accélération dans un intervalle de l’animation. Par défaut, l’accélération pour animer est non linéaire (Sine(.5)), tandis que l’option Accélération pour les images Keyframe est linéaire. Si vous souhaitez un effet avec l’accélération au niveau de l’image-clé, vous pouvez choisir de définir l’accélération de l’effet sur linéaire, puis définissez l’option Accélération spécifiquement sur les images Keyframe.



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

interpolator

propriété 
interpolator:IInterpolator

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 cet effet pour calculer les valeurs situées entre les valeurs de début et de fin d’une propriété. Par défaut, la classe NumberInterpolator gère l’interpolation 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 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.



Implémentation
    public function get interpolator():IInterpolator
    public function set interpolator(value:IInterpolator):void

motionPaths

propriété 
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

Un vecteur d’objets MotionPath contenant chacun le nom d’une propriété animée et les valeurs prises par la propriété au cours de l’animation. Ce vecteur est prioritaire par rapport aux propriétés déclarées dans les sous-classes de la classe Animate. Par exemple, si ce tableau est défini directement sur un effet Move, toutes les propriétés de l’effet Move, par exemple xFrom, sont ignorées.



Implémentation
    public function get motionPaths():Vector.<MotionPath>
    public function set motionPaths(value:Vector.<MotionPath>):void

playheadTime

propriété 
playheadTime:Number[override]

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

Position temporelle actuelle de l’effet. Cette propriété a une valeur comprise entre 0 et la durée totale, qui inclut les propriétés startDelay, repeatCount et repeatDelay de l’effet.



Implémentation
    override public function get playheadTime():Number
    override public function set playheadTime(value:Number):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

Comportement d’un effet répété, c’est-à-dire d’un effet dont la valeur repeatCount est égale à 0 ou 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.



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

AnimateInstance

()Constructeur
public function AnimateInstance(target:Object)

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

Constructeur.

Paramètres
target:Object — Objet à animer à l’aide de cet effet.




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