Adobe® Flex® 4 Language Reference
Show Packages and Classes List |  Packages  |  Classes  |  Index  |  Appendixes
mx.core 
ContainerCreationPolicy 
Packagemx.core
Classpublic final class ContainerCreationPolicy
InheritanceContainerCreationPolicy Inheritance Object

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

The ContainerCreationPolicy class defines the constant values for the creationPolicy property of the Container class.

See also



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
Public Methods
 MethodDefined By
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Public Constants
 ConstantDefined By
  ALL : String = "all"
[static] Immediately create all descendants.
ContainerCreationPolicy
  AUTO : String = "auto"
[static] Delay creating some or all descendants until they are needed.
ContainerCreationPolicy
  NONE : String = "none"
[static] Do not create any children.
ContainerCreationPolicy
  QUEUED : String = "queued"
[static] Add the container to a creation queue.
ContainerCreationPolicy
Constant Detail

ALL

Constant
public static const ALL:String = "all"

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Immediately create all descendants.

Avoid using this creationPolicy because it increases the startup time of your application. There is usually no good reason to create components at startup which the user cannot see. If you are using this policy so that you can "push" data into hidden components at startup, you should instead design your application so that the data is stored in data variables and components which are created later "pull" in this data, via databinding or an initialize handler.

AUTO

Constant 
public static const AUTO:String = "auto"

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Delay creating some or all descendants until they are needed.

For example, if a navigator container such as a TabNavigator has this creationPolicy, it will immediately create all of its children, plus the descendants of the initially selected child. However, it will wait to create the descendants of the other children until the user navigates to them.

NONE

Constant 
public static const NONE:String = "none"

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Do not create any children.

With this creationPolicy, it is the developer's responsibility to programmatically create the children from the UIComponentDescriptors by calling createComponentsFromDescriptors() on the parent container.

QUEUED

Constant 
public static const QUEUED:String = "queued"

Language Version: ActionScript 3.0
Product Version: Flex 3
Runtime Versions: Flash Player 9, AIR 1.1

Add the container to a creation queue. Deprecated since Flex 4.0.