Animate

Package	spark.effects
Classe	public class Animate
Héritage	Animate Effect EventDispatcher Object
Sous-classes	AnimateColor, AnimateFilter, AnimateTransform, AnimateTransitionShader, Fade, Resize

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Cet effet Animate anime un ensemble arbitraire de propriétés entre des valeurs. Spécifiez les propriétés et valeurs à animer en définissant la propriété motionPaths.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <s:Animate> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:Animate
    Properties
    id="ID"
    disableLayout="false"
    easer="{spark.effects.easing.Sine(.5)}"
    interpolator="NumberInterpolator"
    motionPaths="no default"
    repeatBehavior="loop"
  />

Propriété MXML par défautmotionPaths

Consulter les exemples

Eléments de l’API associés

spark.effects.supportClasses.AnimateInstance

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		className : String [lecture seule] Le nom de la classe d’effet, tel que « Fade ».	Effect
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		customFilter : mx.effects:EffectTargetFilter Spécifie un objet filtre personnalisé, de type EffectTargetFilter, utilisé par l’effet pour déterminer les cibles sur lequel lire l’effet.	Effect
		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.	Animate
		duration : Number Durée de l’effet en millisecondes.	Effect
		easer : IEaser Comportement d’accélération de cet effet.	Animate
		effectTargetHost : mx.effects:IEffectTargetHost Propriété qui permet d’accéder au contrôle à base de liste de la cible d’un effet data.	Effect
		filter : String Spécifie un algorithme de filtrage des cibles d’un effet.	Effect
		hideFocusRing : Boolean Détermine si l’effet doit masquer l’anneau de focus lors du démarrage.	Effect
		instanceClass : Class Objet de type Class qui spécifie la classe de l’instance d’effet de cette classe d’effets.	Effect
		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é.	Animate
		isPlaying : Boolean [lecture seule] Indicateur de lecture seule défini sur true si les instances de l’effet sont en cours de lecture et sur false si aucune instance n’est définie.	Effect
		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.	Animate
		perElementOffset : Number Autre délai, en millisecondes, pour les cibles d’effet suivant la première cible de l’effet.	Effect
		playheadTime : Number Temps de position actuelle de l’effet.	Effect
		relevantProperties : Array Tableau de noms de propriété à utiliser pour effectuer le filtrage.	Effect
		relevantStyles : Array Tableau des noms de style à utiliser pour effectuer le filtrage.	Effect
		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.	Animate
		repeatCount : int = 1 Nombre de fois que l’effet doit être répété.	Effect
		repeatDelay : int = 0 Intervalle (en millisecondes), qui s’écoule avant de répéter l’effet.	Effect
		startDelay : int = 0 Intervalle (en millisecondes), qui s’écoule avant de commencer l’effet.	Effect
		target : Object Objet auquel s’applique cet effet.	Effect
		targets : Array Tableau d’objets représentant des cibles de l’effet.	Effect
		triggerEvent : Event Objet Evénement transmis à cet Effet par le gestionnaire EffectManager lorsqu’un effet est déclenché, ou nul si l’effet n’est pas exécuté par le gestionnaire EffectManager.	Effect

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		applyTransitionEndProperties : Boolean Cet indicateur contrôle si l’effet, lorsqu’il est exécuté dans une transition, applique automatiquement les valeurs de propriété conformément à l’état d’arrivée, au lieu de conserver ces valeurs comme l’a défini l’effet lui-même.	Effect
		endValuesCaptured : Boolean = false Drapeau contenant la valeur true si les valeurs d’arrivée d’un effet ont déjà été déterminées, ou false si elles doivent être acquises à partir des propriétés actuelles des cibles de l’effet lorsque l’effet s’exécute.	Effect

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		Animate(target:Object = null) Constructeur.	Animate
		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
		captureEndValues():void Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet et les enregistre en tant que valeurs d’arrivée.	Effect
		captureMoreStartValues(targets:Array):void Capture les valeurs actuelles des propriétés correspondantes d’un autre ensemble de cibles. Flex utilise cette fonction lorsqu’un effet de modifications de données est exécuté.	Effect
		captureStartValues():void Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet.	Effect
		createInstance(target:Object = null):IEffectInstance Crée une seule instance d’effet et l’initialise.	Effect
		createInstances(targets:Array = null):Array Prend un tableau d’objets cible et invoque la méthode createInstance() sur chaque cible.	Effect
		deleteInstance(instance:IEffectInstance):void Supprime les écouteurs d’événement d’une instance et les retire de la liste d’instances.	Effect
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		end(effectInstance:IEffectInstance = null):void Interrompt un effet en cours de lecture et passe immédiatement à la fin de l’effet.	Effect
		getAffectedProperties():Array Renvoie un tableau de chaînes, où chaque chaîne correspond au nom d’une propriété modifiée par cet effet.	Effect
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean 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
		pause():void Interrompt momentanément l’effet jusqu’à un appel de la méthode resume().	Effect
		play(targets:Array = null, playReversedFromEnd:Boolean = false):Array Commence la lecture de l’effet.	Effect
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		resume():void Reprend l’effet après une interruption demandée par un appel de la méthode pause().	Effect
		reverse():void Exécute l’effet en sens inverse, si l’effet est en cours de lecture, à partir de sa position actuelle.	Effect
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		stop():void Arrête l’effet, en laissant les cibles de l’effet dans leur état actuel.	Effect
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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

Méthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		applyValueToTarget(target:Object, property:String, value:*, props:Object):void Utilisée en interne par l’infrastructure Effect.	Effect
		effectEndHandler(event:EffectEvent):void Appelée à la fin de la lecture d’une instance d’effet.	Effect
		effectStartHandler(event:EffectEvent):void Cette méthode est appelée lorsque l’instance d’effet commence.	Effect
		effectStopHandler(event:EffectEvent):void Appelée lorsqu’une instance d’effet a été interrompue par un appel de la méthode stop().	Effect
		filterInstance(propChanges:Array, target:Object):Boolean Détermine la logique de filtrage d’une instance d’effet.	Effect
		getValueFromTarget(target:Object, property:String):* Appelée par la méthode captureStartValues() pour obtenir la valeur d’une propriété à partir de la cible.	Effect
		initInstance(instance:IEffectInstance):void Copie les propriétés de l’effet vers l’instance d’effet.	Effect

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
effectEnd	Distribué lorsque la lecture de l’une des instances de l’effet s’arrête, soit lorsque la lecture de l’instance s’arrête, soit lorsque l’effet est interrompu par un appel de la méthode end().	Effect
effectRepeat	Distribué au début de chaque répétition de l’effet, dans le cas d’un effet répété.	Animate
effectStart	Diffusé lorsque l’exécution de l’effet commence.	Effect
effectStop	Distribué lorsque l’effet a été interrompu, ce qui se produit uniquement lorsque l’effet est interrompu par un appel de la méthode stop().	Effect
effectUpdate	Distribué chaque fois que l’effet met à jour la cible.	Animate

Détails de la propriété

disableLayout

propriété

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.

La valeur par défaut est false.

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

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.

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

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

Eléments de l’API associés

spark.effects.easing.Sine

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

Eléments de l’API associés

spark.effects.interpolation.NumberInterpolator
spark.effects.interpolation.MultiValueInterpolator

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

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.

La valeur par défaut est RepeatBehavior.LOOP.

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

Détails du constructeur

()

Constructeur

public function Animate(target: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.

Paramètres

target:Object (default = null) — Objet à animer à l’aide de cet effet.

Détails de l’événement

effectRepeat

Evénement

Type d’objet d’événement: mx.events.EffectEvent
propriété EffectEvent.type = mx.events.EffectEvent.EFFECT_REPEAT

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distribué au début de chaque répétition de l’effet, dans le cas d’un effet répété. Flex distribue en même temps un événement effectUpdate pour l’effet.

La constante EffectEvent.EFFECT_REPEAT définit la valeur de la propriété type de l’objet d’événement d’un événement effectRepeat.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	false
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`effectInstance`	Objet d’instance d’effet de l’événement.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.

effectUpdate

Evénement

Type d’objet d’événement: mx.events.EffectEvent
propriété EffectEvent.type = mx.events.EffectEvent.EFFECT_UPDATE

Version du langage:

ActionScript 3.0

Version du produit:

Flex 4

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Distribué chaque fois que l’effet met à jour la cible.

La constante EffectEvent.EFFECT_UPDATE définit la valeur de la propriété type de l’objet d’événement d’un événement effectUpdate.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	false
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`effectInstance`	Objet d’instance d’effet de l’événement.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.

Exemples Comment utiliser cet exemple

AnimateEffectExample.mxml

<?xml version="1.0"?>
<s:Application
    xmlns:fx="http://ns.adobe.com/mxml/2009"
    xmlns:mx="library://ns.adobe.com/flex/mx"
    xmlns:s="library://ns.adobe.com/flex/spark">

    <fx:Declarations>
        <s:Animate id="animateEffect"
            target="{targetBox}" repeatCount="2" repeatBehavior="reverse" disableLayout="true" effectStart="playButton.enabled=false" effectEnd="playButton.enabled=true;">
            <s:motionPaths>
                <s:SimpleMotionPath property="x" valueFrom="0" valueTo="100"/>
                <s:SimpleMotionPath property="alpha" valueFrom="1" valueTo="0"/>
            </s:motionPaths>
        </s:Animate>
    </fx:Declarations>

    <s:Panel title="Animate Effect Example"
        width="75%" height="75%">

        <mx:HBox width="100%" height="100%">
            <!-- Our target to affect-->
            <mx:VBox id="targetBox" width="50%"  horizontalAlign="center">
                <mx:Label text="Nokia 9930" />
                <mx:Image id="targetImg" source="@Embed(source='assets/Nokia_6630.png')"/>
            </mx:VBox>
            <mx:VBox id="detailsBox" width="50%" left="0">
                <mx:Text width="99%" color="blue"
                    text="The Animate effect animates any property or style of an object over time using animationProperty arrays. Click 'Animate' to watch the effect."/>
            </mx:VBox>
        </mx:HBox>

        <s:Rect left="0" right="0" bottom="0" height="30">
            <s:fill>
                <s:LinearGradient rotation="90">
                    <s:GradientEntry color="0xE2E2E2" />
                    <s:GradientEntry color="0xD9D9D9" />
                </s:LinearGradient>
            </s:fill>
        </s:Rect>
        <s:Button id="playButton"
            left="5" bottom="5"
            label="Animate"
            click="animateEffect.play();"/>
    </s:Panel>
</s:Application>

Informations juridiques | Politique de confidentialité en ligne

Animate - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package spark.effects

disableLayout

easer

interpolator

motionPaths

repeatBehavior

Animate

effectRepeat

effectUpdate