| Package | mx.states |
| Classe | public class AddChild |
| Héritage | AddChild  OverrideBase OnDemandEventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
overrides de la classe State. Utilisez la propriété creationPolicy à indiquer pour créer l’enfant au démarrage de l’application ou lors de la modification d’un état d’affichage.
L’enfant ne distribue pas l’événement creationComplete tant qu’il n’a pas été ajouté à un conteneur. Par exemple, le code suivant ajoute un contrôle Button dans le cadre d’une modification d’état d’affichage :
<mx:AddChild relativeTo="{v1}">
<mx:Button id="b0" label="New Button"/>
</mx:AddChild>
Dans l’exemple précédent, le contrôle Button ne distribue pas l’événement creationComplete tant que vous n’avez pas modifié l’état et que le contrôle Button n’a pas été ajouté à un conteneur. Si la classe AddChild définit à la fois le contrôle Button et un conteneur tel que Canvas, le contrôle Button distribue l’événement creationComplete lors de sa création. Par exemple, si la propriété creationPolicy est définie sur all, le contrôle Button distribue l’événement au démarrage de l’application. Si la propriété creationPolicy est définie sur auto, le contrôle Button distribue l’événement lorsque vous modifiez l’état d’affichage.
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:AddChild> tag
has the following attributes:
<mx:AddChild Properties target="null" targetFactory="null" creationPolicy="auto" position="lastChild" relativeTo="parent of the State object" />
Propriété MXML par défauttargetFactory
Eléments de l’API associés
| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| creationPolicy : String
Stratégie de création pour cet enfant. | AddChild | ||
| position : String
Position de l’enfant dans la liste d’affichage, par rapport à l’objet spécifié par la propriété relativeTo. | AddChild | ||
| relativeTo : Object
Objet par rapport auquel l’enfant est ajouté. | AddChild | ||
| target : DisplayObject
Enfant à ajouter | AddChild | ||
| targetFactory : IDeferredInstance
Fabrique qui crée l’enfant. | AddChild | ||
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | AddChild | ||
| 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. | OnDemandEventDispatcher | |
[override]
Applique le remplacement. | AddChild | ||
Crée l’instance enfant à partir de la fabrique. | AddChild | ||
|
Distribue un événement dans le flux d’événements. | OnDemandEventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | OnDemandEventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
[override]
Méthode d’interface IOverride ; cette classe l’implémente en tant que méthode vide. | AddChild | ||
|
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 | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
[override]
Supprime le remplacement. | AddChild | ||
|
Supprime un écouteur de l’objet EventDispatcher. | OnDemandEventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
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é. | OnDemandEventDispatcher | |
creationPolicy | propriété |
creationPolicy:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Stratégie de création pour cet enfant. Cette propriété détermine quand la classe targetFactory crée l’instance de l’enfant. Flex utilise cette propriété uniquement si vous spécifiez une propriété targetFactory. Les valeurs suivantes sont possibles :
| Valeur | Signification |
|---|---|
auto | (Par défaut)Crée l’instance la première fois qu’elle est requise. |
all | Crée l’instance au démarrage de l’application. |
aucun | Ne crée pas automatiquement l’instance. Vous devez appeler la méthode createInstance()pour créer l’instance. |
La valeur par défaut est "auto".
Implémentation
public function get creationPolicy():String public function set creationPolicy(value:String):voidposition | propriété |
public var position:String| 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" et "lastChild".
La valeur par défaut est "lastChild".
relativeTo | propriété |
public var relativeTo:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Objet par rapport auquel l’enfant est ajouté. Cette propriété s’utilise en combinaison avec la propriété position. Cette propriété est facultative. Si vous l’omettez, Flex utilise le parent immédiat de l’objet State, c’est-à-dire, le composant possédant la propriété states ou la balise <mx:states> qui spécifie l’objet State.
target | propriété |
target:DisplayObject| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Enfant à ajouter Si vous définissez cette propriété, l’instance enfant est créée au démarrage de l’application. La définition de cette propriété est équivalente à celle d’une propriété targetFactory avec une valeur creationPolicy égale à "all".
Ne définissez pas cette propriété si vous définissez la propriété targetFactory.
Implémentation
public function get target():DisplayObject public function set target(value:DisplayObject):voidtargetFactory | propriété |
targetFactory:IDeferredInstance| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fabrique qui crée l’enfant. Vous pouvez spécifier l’un des éléments suivants :
- Une classe usine qui implémente l’interface IDeferredInstance et crée la ou les instances enfant.
- Un composant Flex (c’est-à-dire, toute classe qui est une sous-classe de la classe UIComponent), tels que le contrôle Button. Si vous utilisez un composant Flex, le compilateur Flex imbrique automatiquement le composant dans une classe usine.
Si vous définissez cette propriété, l’enfant est instanciée au moment déterminé par la propriété creationPolicy.
Ne définissez pas cette propriété si vous définissez la propriété target. Il s’agit de la propriété par défaut de la classe AddChild. La définition de cette propriété sur la valeur « all » de la stratégie creationPolicy est équivalente à la définition d’une propriété target.
Implémentation
public function get targetFactory():IDeferredInstance public function set targetFactory(value:IDeferredInstance):voidAddChild | () | Constructeur |
public function AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")| 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ètresrelativeTo:UIComponent (default = null) | |
target:DisplayObject (default = null) | |
position:String (default = "lastChild")target par rapport au composant relativeTo. Il doit s’agir de l’une des valeurs suivantes : « firstChild », « lastChild », « before » ou « after ».
|
apply | () | méthode |
override public function apply(parent:UIComponent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Applique le remplacement. Flex conserve la valeur d’origine, afin de pouvoir la restaurer ultérieurement dans la méthode remove().
Cette méthode est appelée automatiquement lors de la saisie de l’état. Elle ne doit pas être appelée directement.
Paramètres
parent:UIComponent — Parent de l’objet d’état contenant ce remplacement. Le remplacement doit l’utiliser si aucune cible explicite n’a été spécifiée.
|
createInstance | () | méthode |
public function createInstance():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Crée l’instance enfant à partir de la fabrique. Vous devez utiliser cette méthode uniquement si vous spécifiez une propriété targetFactory et une valeur creationPolicy égale à "none". Flex appelle automatiquement cette méthode si la valeur de la propriété creationPolicy est définie sur "auto" ou "all". Si vous appelez cette méthode plusieurs fois, l’instance enfant est créée uniquement au premier appel.
initialize | () | méthode |
override public function initialize():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Méthode d’interface IOverride ; cette classe l’implémente en tant que méthode vide.
remove | () | méthode |
override public function remove(parent:UIComponent):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime le remplacement. La valeur mémorisées dans la méthode apply() est restaurée.
Cette méthode est appelée automatiquement lors de la saisie de l’état. Elle ne doit pas être appelée directement.
Paramètres
parent:UIComponent — Parent de l’objet d’état contenant ce remplacement. Le remplacement doit l’utiliser si aucune cible explicite n’a été spécifiée.
|
Tue Jun 12 2018, 09:30 AM Z