mx.core

# ContainerCreationPolicy - AS3 Flex

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.

Related API Elements

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

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.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00