////////////////////////////////////////////////////////////////////////////////
//
// Licensed to the Apache Software Foundation (ASF) under one or more
// contributor license agreements. See the NOTICE file distributed with
// this work for additional information regarding copyright ownership.
// The ASF licenses this file to You under the Apache License, Version 2.0
// (the "License"); you may not use this file except in compliance with
// the License. You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
////////////////////////////////////////////////////////////////////////////////
package mx.core
{
/**
* The ContainerCreationPolicy class defines the constant values
* for the creationPolicy
property of the Container class.
*
* @see mx.core.Container#creationPolicy
*
* @langversion 3.0
* @playerversion Flash 9
* @playerversion AIR 1.1
* @productversion Flex 3
*/
public final class ContainerCreationPolicy
{
include "../core/Version.as";
//--------------------------------------------------------------------------
//
// Class constants
//
//--------------------------------------------------------------------------
/**
* 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.
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.
With this creationPolicy
, it is the developer's
* responsibility to programmatically create the children
* from the UIComponentDescriptors by calling
* createComponentsFromDescriptors()
* on the parent container.