AddChild

Pacchetto	mx.states
Classe	public class AddChild
Ereditarietà	AddChild OverrideBase OnDemandEventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The AddChild class adds a child display object, such as a component, to a container as part of a view state. You use this class in the overrides property of the State class. Use the creationPolicy property to specify to create the child at application startup or when you change to a view state.

The child does not dispatch the creationComplete event until it is added to a container. For example, the following code adds a Button control as part of a view state change:

  <mx:AddChild relativeTo="{v1}">
      <mx:Button id="b0" label="New Button"/>
  </mx:AddChild>

In the previous example, the Button control does not dispatch the creationComplete event until you change state and the Button control is added to a container. If the AddChild class defines both the Button and a container, such as a Canvas container, then the Button control dispatches the creationComplete event when it is created. For example, if the creationPolicy property is set to all, the Button control dispatches the event at application startup. If the creationPolicy property is set to auto, the Button control dispatches the event when you change to the view state.

Sintassi MXML expanded

Nascondi sintassi 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"
  />

Proprietà MXML predefinitatargetFactory

Elementi API correlati

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

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		creationPolicy : String The creation policy for this child.	AddChild
		position : String The position of the child in the display list, relative to the object specified by the relativeTo property.	AddChild
		relativeTo : Object The object relative to which the child is added.	AddChild
		target : DisplayObject The child to be added.	AddChild
		targetFactory : IDeferredInstance The factory that creates the child.	AddChild

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild") Constructor.	AddChild
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.	OnDemandEventDispatcher
		apply(parent:UIComponent):void [override] Applies the override.	AddChild
		createInstance():void Creates the child instance from the factory.	AddChild
		dispatchEvent(event:Event):Boolean Dispatches an event into the event flow.	OnDemandEventDispatcher
		hasEventListener(type:String):Boolean Checks whether the EventDispatcher object has any listeners registered for a specific type of event.	OnDemandEventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		initialize():void [override] IOverride interface method; this class implements it as an empty method.	AddChild
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		remove(parent:UIComponent):void [override] Removes the override.	AddChild
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Removes a listener from the EventDispatcher object.	OnDemandEventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.	OnDemandEventDispatcher

Descrizione delle proprietà

creationPolicy

proprietà

creationPolicy:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The creation policy for this child. This property determines when the targetFactory will create the instance of the child. Flex uses this properthy only if you specify a targetFactory property. The following values are valid:

Value	Meaning
`auto`	(default)Create the instance the first time it is needed.
`all`	Create the instance when the application started up.
`none`	Do not automatically create the instance. You must call the `createInstance()` method to create the instance.

Il valore predefinito è "auto".

Implementazione
public function get creationPolicy():String
public function set creationPolicy(value:String):void

position

proprietà

public var position:String

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The position of the child in the display list, relative to the object specified by the relativeTo property. Valid values are "before", "after", "firstChild", and "lastChild".

Il valore predefinito è "lastChild".

relativeTo

proprietà

public var relativeTo:Object

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The object relative to which the child is added. This property is used in conjunction with the position property. This property is optional; if you omit it, Flex uses the immediate parent of the State object, that is, the component that has the states property, or <mx:states>tag that specifies the State object.

target

proprietà

target:DisplayObject

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The child to be added. If you set this property, the child instance is created at app startup. Setting this property is equivalent to setting a targetFactory property with a creationPolicy of "all".

Do not set this property if you set the targetFactory property.

Implementazione
public function get target():DisplayObject
public function set target(value:DisplayObject):void

targetFactory

proprietà

targetFactory:IDeferredInstance

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

The factory that creates the child. You can specify either of the following items:

A factory class that implements the IDeferredInstance interface and creates the child instance or instances.
A Flex component, (that is, any class that is a subclass of the UIComponent class), such as the Button contol. If you use a Flex component, the Flex compiler automatically wraps the component in a factory class.

If you set this property, the child is instantiated at the time determined by the creationPolicy property.

Do not set this property if you set the target property. This propety is the AddChild class default property. Setting this property with a creationPolicy of "all" is equivalent to setting a target property.

Implementazione
public function get targetFactory():IDeferredInstance
public function set targetFactory(value:IDeferredInstance):void

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Constructor.

Parametri

	`relativeTo:UIComponent` (default = `null`) — The component relative to which child is added.

	`target:DisplayObject` (default = `null`) — The child object. All Flex components are subclasses of the DisplayObject class.

	`position:String` (default = "`lastChild`") — the location in the display list of the `target` relative to the `relativeTo` component. Must be one of the following: "firstChild", "lastChild", "before" or "after".

Descrizione dei metodi

apply

()

metodo

override public function apply(parent:UIComponent):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Applies the override. Flex retains the original value, so that it can restore the value later in the remove() method.

This method is called automatically when the state is entered. It should not be called directly.

Parametri

parent:UIComponent — The parent of the state object containing this override. The override should use this as its target if an explicit target was not specified.

createInstance

()

metodo

public function createInstance():void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Creates the child instance from the factory. You must use this method only if you specify a targetFactory property and a creationPolicy value of "none". Flex automatically calls this method if the creationPolicy property value is "auto" or "all". If you call this method multiple times, the child instance is created only on the first call.

initialize

()

metodo

override public function initialize():void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

IOverride interface method; this class implements it as an empty method.

remove

()

metodo

override public function remove(parent:UIComponent):void

Versione linguaggio:

ActionScript 3.0

Versione prodotto:

Flex 3

Versioni runtime:

Flash Player 9, AIR 1.1

Removes the override. The value remembered in the apply() method is restored.

This method is called automatically when the state is entered. It should not be called directly.

Parametri

parent:UIComponent — The parent of the state object containing this override. The override should use this as its target if an explicit target was not specified.

Note legali | Informativa sulla privacy online

AddChild - AS3 Flex

Classi x

creationPolicy

position

relativeTo

target

targetFactory

AddChild

apply

createInstance

initialize

remove