| Package | mx.effects |
| Classe | public class AddChildAction |
| Héritage | AddChildAction  Effect EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
 | A partir de Flex 4.0, Adobe vous recommande d’utiliser la classe spark.effects.AddAction comme alternative à cette classe. |
La classe AddChildAction définit un effet d’action qui correspond à la propriété
AddChild de la définition d’un état d’affichage. Utilisez un effet AddChildAction dans une définition de transition pour contrôler lorsque la modification de l’état d’affichage défini par une propriété AddChild se produit pendant la transition.
Syntaxe MXML
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:AddChildAction> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:AddChildAction
Properties
id="ID"
index="-1"
relativeTo=""
position="index"
/>
Eléments de l’API associés
Propriétés publiques
| 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 | |
| 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 | |
| index : int = -1
Index de l’enfant dans le parent. | AddChildAction | ||
| instanceClass : Class
Objet de type Class qui spécifie la classe de l’instance d’effet de cette classe d’effets. | Effect | |
| 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 | |
| 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 | |
| position : String = "index"
Position de l’enfant dans la liste d’affichage, par rapport à l’objet spécifié par la propriété relativeTo. | AddChildAction | ||
| relativeTo : DisplayObjectContainer
Emplacement dans lequel le composant enfant est ajouté. | AddChildAction | ||
| 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 | |
| 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 | |
| suspendBackgroundProcessing : Boolean = false
Si la valeur est true, elle bloque tout le traitement en arrière-plan pendant l’exécution de 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
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
AddChildAction(target:Object = null)
Constructeur. | AddChildAction | ||
| 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 | |
|
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 | |
|
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 | |
|
Capture les valeurs actuelles des propriétés correspondantes sur les cibles de l’effet. | Effect | |
|
Crée une seule instance d’effet et l’initialise. | Effect | |
|
Prend un tableau d’objets cible et invoque la méthode createInstance() sur chaque cible. | Effect | |
|
Supprime les écouteurs d’événement d’une instance et les retire de la liste d’instances. | Effect | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Interrompt un effet en cours de lecture et passe immédiatement à la fin de l’effet. | Effect | |
|
Renvoie un tableau de chaînes, où chaque chaîne correspond au nom d’une propriété modifiée par cet effet. | Effect | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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 | |
|
Interrompt momentanément l’effet jusqu’à un appel de la méthode resume(). | Effect | |
|
Commence la lecture de l’effet. | Effect | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Reprend l’effet après une interruption demandée par un appel de la méthode pause(). | Effect | |
|
Exécute l’effet en sens inverse, si l’effet est en cours de lecture, à partir de sa position actuelle. | Effect | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Arrête l’effet, en laissant les cibles de l’effet dans leur état actuel. | Effect | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
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
Evénements
Détails de la propriété
index | propriété |
public var index:int = -1| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Index de l’enfant dans le parent. La valeur -1 signifie que l’enfant doit être ajouté comme dernier enfant du parent.
La valeur par défaut est -1.
position | propriété |
public var position:String = "index"| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Position de l’enfant dans la liste d’affichage, par rapport à l’objet spécifié par la propriété relativeTo. Les valeurs possibles sont "before", "after", "firstChild", "last child" et "index", où "index" spécifie d’utiliser la propriété index pour déterminer la position de l’enfant.
La valeur par défaut est "index".
relativeTo | propriété |
public var relativeTo:DisplayObjectContainer| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Position à laquelle le composant enfant est ajouté. Par défaut, Flex détermine cette valeur à partir de la propriété AddChild de la définition d’état d’affichage.
Détails du constructeur
AddChildAction | () | Constructeur |
Exemples Comment utiliser cet exemple
TransitionExample.mxml
<?xml version="1.0" ?>
<!-- Simple example to demonstrate the Transition class. -->
<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" currentState="Login">
<!-- Define the view states -->
<s:states>
<s:State name="Login" />
<s:State name="Register" />
</s:states>
<s:transitions>
<!-- Define the transition from the base state to the Register state.-->
<s:Transition id="toRegister" fromState="*" toState="Register">
<s:Sequence targets="{[loginPanel, registerLink, confirm, loginLink]}">
<s:RemoveAction />
<s:Fade />
<s:SetAction target="{loginPanel}" property="title" />
<s:SetAction target="{loginButton}" property="label" />
<s:SetAction target="{loginButton}" property="color" />
<s:Resize target="{loginPanel}"/>
<s:AddAction />
<s:Fade />
</s:Sequence>
</s:Transition>
<!-- Define the transition from the Register state to the base state.-->
<s:Transition id="toDefault" fromState="Register" toState="*">
<s:Sequence targets="{[loginPanel, registerLink,
confirm, loginLink]}">
<s:RemoveAction/>
<s:SetAction target="{loginPanel}" property="title"/>
<s:SetAction target="{loginButton}" property="label"/>
<s:SetAction target="{loginButton}" property="color"/>
<s:Resize target="{loginPanel}"/>
<s:AddAction/>
</s:Sequence>
</s:Transition>
</s:transitions>
<!-- Define a Panel container that defines the login form. The title of the Panel
changes depending on the state. -->
<s:Panel title="Login" title.Register="Register" id="loginPanel"
width="75%" horizontalCenter="0" verticalCenter="0">
<s:controlBarLayout >
<s:BasicLayout />
</s:controlBarLayout>
<s:layout>
<s:VerticalLayout paddingTop="10" paddingBottom="10" paddingRight="10" paddingLeft="10" />
</s:layout>
<s:Label color="blue" width="100%"
text="Click the 'Need to Register?' link to change state. Click the 'Return to Login' link to return to the base state."/>
<!-- The following form has two TextInputs in the Login state and three TextInputs
in the Register state. -->
<s:Form id="loginForm" >
<s:FormItem label="Username:">
<s:TextInput/>
</s:FormItem>
<s:FormItem label="Password:">
<s:TextInput/>
</s:FormItem>
<s:FormItem id="confirm" label="Confirm:" includeIn="Register" includeInLayout="false" includeInLayout.Register="true">
<s:TextInput/>
</s:FormItem>
</s:Form>
<!-- The controlBar includes two visible items in each state. Which LinkButton is visible is determined
by the state -->
<s:controlBarContent>
<mx:LinkButton id="registerLink" label="Need to Register?" top="10" bottom="10"
click="currentState='Register'" left="10" includeIn="Login" />
<mx:LinkButton id="loginLink" label="Return to Login" click="currentState=''" includeIn="Register" left="10" top="10" bottom="10"/>
<s:Button label="Login" label.Register="Register" id="loginButton" right="10" color.Register="0x0000FF" top="10" bottom="10"/>
</s:controlBarContent>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z