| Paquete | mx.states |
| Clase | public class AddChild |
| Herencia | AddChild  OverrideBase OnDemandEventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
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.
Mostrar sintaxis MXML
Ocultar sintaxis 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" />
Propiedad MXML predeterminadatargetFactory
Elementos de API relacionados
| Propiedad | Definido por | ||
|---|---|---|---|
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | 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 | ||
| Método | Definido por | ||
|---|---|---|---|
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 | |
[override]
Applies the override. | AddChild | ||
Creates the child instance from the factory. | AddChild | ||
|
Dispatches an event into the event flow. | OnDemandEventDispatcher | |
|
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | OnDemandEventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
[override]
IOverride interface method; this class implements it as an empty method. | AddChild | ||
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
[override]
Removes the override. | AddChild | ||
|
Removes a listener from the EventDispatcher object. | OnDemandEventDispatcher | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. | OnDemandEventDispatcher | |
creationPolicy | propiedad |
creationPolicy:String| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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. |
El valor predeterminado es "auto".
Implementación
public function get creationPolicy():String public function set creationPolicy(value:String):voidposition | propiedad |
public var position:String| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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".
El valor predeterminado es "lastChild".
relativeTo | propiedad |
public var relativeTo:Object| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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 | propiedad |
target:DisplayObject| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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.
Implementación
public function get target():DisplayObject public function set target(value:DisplayObject):voidtargetFactory | propiedad |
targetFactory:IDeferredInstance| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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.
Implementación
public function get targetFactory():IDeferredInstance public function set targetFactory(value:IDeferredInstance):voidAddChild | () | Información sobre |
public function AddChild(relativeTo:UIComponent = null, target:DisplayObject = null, position:String = "lastChild")| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
Constructor.
ParámetrosrelativeTo:UIComponent (default = null) | |
target:DisplayObject (default = null) | |
position:String (default = "lastChild")target
relative to the relativeTo component. Must be one of the following:
"firstChild", "lastChild", "before" or "after".
|
apply | () | método |
override public function apply(parent:UIComponent):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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.
Parámetros
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 | () | método |
public function createInstance():void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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 | () | método |
override public function initialize():void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | Flash Player 9, AIR 1.1 |
IOverride interface method; this class implements it as an empty method.
remove | () | método |
override public function remove(parent:UIComponent):void| Versión del lenguaje: | ActionScript 3.0 |
| Versión de producto: | Flex 3 |
| Versiones de motor de ejecución: | 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.
Parámetros
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.
|
Tue Jun 12 2018, 02:12 PM Z