AddChild

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

La classe AddChild ajoute un objet d’affichage enfant, tel qu’un composant, à un conteneur en tant qu’état d’affichage. Utilisez cette classe dans la propriété 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.

Syntaxe MXML expanded

Masquer la syntaxe MXML

The <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

mx.states.State
mx.states.RemoveChild
mx.states.Transition
mx.effects.AddChildAction

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
		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éthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild") 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
		apply(parent:UIComponent):void [override] Applique le remplacement.	AddChild
		createInstance():void Crée l’instance enfant à partir de la fabrique.	AddChild
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	OnDemandEventDispatcher
		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.	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialize():void [override] Méthode d’interface IOverride ; cette classe l’implémente en tant que méthode vide.	AddChild
		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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		remove(parent:UIComponent):void [override] Supprime le remplacement.	AddChild
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		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é.	OnDemandEventDispatcher

Détails de la propriété

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):void

position

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):void

targetFactory

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):void

Détails du constructeur

()

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ètres

	`relativeTo:UIComponent` (default = `null`) — Composant par rapport auquel l’enfant est ajouté.

	`target:DisplayObject` (default = `null`) — Objet enfant. Tous les composants Flex sont des sous-classes de la classe DisplayObject.

	`position:String` (default = "`lastChild`") — Emplacement dans la liste d’affichage de l’objet `target` par rapport au composant `relativeTo`. Il doit s’agir de l’une des valeurs suivantes : « firstChild », « lastChild », « before » ou « after ».

Détails de la méthode

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.

Informations juridiques | Politique de confidentialité en ligne

AddChild - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.states

creationPolicy

position

relativeTo

target

targetFactory

AddChild

apply

createInstance

initialize

remove