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...
mx.effects 

Pause  - AS3 Flex

Packagemx.effects
Classepublic class Pause
HéritagePause Inheritance TweenEffect Inheritance Effect Inheritance EventDispatcher Inheritance Object

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

L’effet Pause est très utile lors de la mise en séquence des effets. Cette méthode est sans effet pendant la période de temps spécifiée ou jusqu’à ce qu’un événement précis soit envoyé par la cible. Si vous ajoutez un effet Pause en tant qu’enfant d’un effet Sequence, vous pouvez créer une pause entre les deux autres effets.

Syntaxe MXMLexpandedMasquer la syntaxe MXML

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

  <mx:Pause 
    id="ID" 
    eventName="null"
  />
  

Consulter les exemples

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 InheritedclassName : String
[lecture seule] Le nom de la classe d’effet, tel que « Fade ».
Effect
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 InheritedcustomFilter : 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
  duration : Number
[override] La propriété duration contrôle la quantité de temps pendant laquelle cet effet sera interrompu.
Pause
 InheritedeasingFunction : Function = null
Fonction d’accélération pour l’animation.
TweenEffect
 InheritedeffectTargetHost : mx.effects:IEffectTargetHost
Propriété qui permet d’accéder au contrôle à base de liste de la cible d’un effet data.
Effect
  eventName : String
Nom de l’événement que l’effet Pause attend avant de s’arrêter.
Pause
 Inheritedfilter : String
Spécifie un algorithme de filtrage des cibles d’un effet.
Effect
 InheritedhideFocusRing : Boolean
Détermine si l’effet doit masquer l’anneau de focus lors du démarrage.
Effect
 InheritedinstanceClass : Class
Objet de type Class qui spécifie la classe de l’instance d’effet de cette classe d’effets.
Effect
 InheritedisPlaying : 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
 InheritedperElementOffset : Number
Autre délai, en millisecondes, pour les cibles d’effet suivant la première cible de l’effet.
Effect
 InheritedplayheadTime : Number
Temps de position actuelle de l’effet.
Effect
 InheritedrelevantProperties : Array
Tableau de noms de propriété à utiliser pour effectuer le filtrage.
Effect
 InheritedrelevantStyles : Array
Tableau des noms de style à utiliser pour effectuer le filtrage.
Effect
 InheritedrepeatCount : int = 1
Nombre de fois que l’effet doit être répété.
Effect
 InheritedrepeatDelay : int = 0
Intervalle (en millisecondes), qui s’écoule avant de répéter l’effet.
Effect
 InheritedstartDelay : int = 0
Intervalle (en millisecondes), qui s’écoule avant de commencer l’effet.
Effect
 InheritedsuspendBackgroundProcessing : Boolean = false
Si la valeur est true, elle bloque tout le traitement en arrière-plan pendant l’exécution de l’effet.
Effect
 Inheritedtarget : Object
Objet auquel s’applique cet effet.
Effect
 Inheritedtargets : Array
Tableau d’objets représentant des cibles de l’effet.
Effect
 InheritedtriggerEvent : 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
 PropriétéDéfini par
 InheritedapplyTransitionEndProperties : 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
 InheritedendValuesCaptured : 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
 MéthodeDéfini par
  
Pause(target:Object = null)
Constructeur.
Pause
 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
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
 Inherited
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
 Inherited
Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet.
Effect
 Inherited
Crée une seule instance d’effet et l’initialise.
Effect
 Inherited
createInstances(targets:Array = null):Array
Prend un tableau d’objets cible et invoque la méthode createInstance() sur chaque cible.
Effect
 Inherited
Supprime les écouteurs d’événement d’une instance et les retire de la liste d’instances.
Effect
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
end(effectInstance:IEffectInstance = null):void
Interrompt un effet en cours de lecture et passe immédiatement à la fin de l’effet.
Effect
 Inherited
Renvoie un tableau de chaînes, où chaque chaîne correspond au nom d’une propriété modifiée par cet effet.
Effect
 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
 Inherited
Interrompt momentanément l’effet jusqu’à un appel de la méthode resume().
Effect
 Inherited
play(targets:Array = null, playReversedFromEnd:Boolean = false):Array
Commence la lecture de l’effet.
Effect
 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().
Effect
 Inherited
Exécute l’effet en sens inverse, si l’effet est en cours de lecture, à partir de sa position actuelle.
Effect
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Arrête l’effet, en laissant les cibles de l’effet dans leur état actuel.
Effect
 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
Méthodes protégées
 MéthodeDéfini par
 Inherited
applyValueToTarget(target:Object, property:String, value:*, props:Object):void
Utilisée en interne par l’infrastructure Effect.
Effect
 Inherited
Appelée à la fin de la lecture d’une instance d’effet.
Effect
 Inherited
Cette méthode est appelée lorsque l’instance d’effet commence.
Effect
 Inherited
Appelée lorsqu’une instance d’effet a été interrompue par un appel de la méthode stop().
Effect
 Inherited
filterInstance(propChanges:Array, target:Object):Boolean
Détermine la logique de filtrage d’une instance d’effet.
Effect
 Inherited
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
 Inherited
Copie les propriétés de l’effet vers l’instance d’effet.
Effect
 Inherited
Appelée lorsque l’objet TweenEffect distribue l’objet TweenEvent.
TweenEffect
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
 InheritedDistribué 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
 InheritedDiffusé lorsque l’exécution de l’effet commence.Effect
 InheritedDistribué 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
 InheritedEnvoyé lorsque l’effet Tween s’arrête.TweenEffect
 InheritedEnvoyé lorsque l’effet tween commence, ce qui correspond au premier appel de la méthode onTweenUpdate().TweenEffect
 InheritedEnvoyé chaque fois que l’effet tween met à jour la cible.TweenEffect
Détails de la propriété

duration

propriété
duration:Number[override]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

La propriété duration contrôle la quantité de temps pendant laquelle cet effet sera interrompu. La propriété duration envoie également un délai d’attente nécessaire au déclenchement de l’événement, si la méthode eventName a été définie sur cet effet. Si la durée est inférieure à 0, l’effet doit attendre indéfiniment que l’événement soit déclenché. Si elle est définie sur un autre délai, y compris 0, l’effet s’arrête, lorsque cette durée s’est écoulée ou lorsque l’événement nommé se déclenche, le premier des deux prévalant.

La valeur par défaut est 500.



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

Eléments de l’API associés

eventName

propriété 
public var eventName:String

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Nom de l’événement que l’effet Pause attend avant de s’arrêter. Ce paramètre doit être utilisé en combinaison avec la propriété target, qui doit être de type IEventDispatcher. Tous les événements doivent provenir d’un répartiteur.

L’écoute de l’événement eventName est également liée à la propriété duration qui agit comme délai pour l’événement. Si l’événement n’est pas reçu dans le délai spécifié par la duration, l’effet s’arrête malgré tout.

Cette propriété est facultative ; l’action par défaut est d’exécuter sans attendre un événement.

Détails du constructeur

Pause

()Constructeur
public function Pause(target:Object = null)

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Constructeur.

Paramètres
target:Object (default = null) — Cet argument est ignoré par l’effet pause si aucun attribut eventName n’a été affecté. S’il existe un attribut eventName, la cible doit être un objet de type IEventDispatcher, car il est prévu pour envoyer l’événement portant ce nom. Une cible de valeur nulle est autorisée pour cet effet, car un effet Pause contenant juste une propriété duration n’agit sur aucune cible spécifique et n’en nécessite donc pas.
PauseEffectExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Pause effect. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

    <fx:Script>
        <![CDATA[
            import mx.effects.easing.*;
        ]]>
    </fx:Script>
    <fx:Declarations>
        <mx:Sequence id="movePauseMove">
            <mx:Move xBy="150" duration="2000" easingFunction="Bounce.easeOut"/>
            <mx:Pause duration="2000"/>
            <mx:Move xBy="-150" duration="2000" easingFunction="Bounce.easeIn"/>
        </mx:Sequence>
    </fx:Declarations>
    <s:Panel title="Pause Effect Example" width="75%" height="75%" >
        <s:VGroup left="20" right="20" top="20" bottom="20">

            <s:Label width="100%" color="blue"
                text="Click the phone image to start the Sequence effect. The effect pauses for 2 seconds between moves."/>

           <mx:Image
                source="@Embed(source='assets/Nokia_6630.png')"
                mouseDownEffect="{movePauseMove}"/>
        </s:VGroup>
    </s:Panel>
</s:Application>




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