Apache Flex 4.16.0 API Reference | All Packages | All Classes | Index | Frames No Frames |
ContainerCreationPolicy

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

Sun Mar 5 2017, 03:42 PM +11:00