mx.core.ContainerCreationPolicy - Adobe® Flex® 4 Language Reference (Flex 4)

Package	mx.core
Class	public final class ContainerCreationPolicy
Inheritance	ContainerCreationPolicy 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

mx.core.Container.creationPolicy

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Public Constants

	Constant		Defined 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.