1//////////////////////////////////////////////////////////////////////////////// 2// 3// ADOBE SYSTEMS INCORPORATED 4// Copyright 2005-2006 Adobe Systems Incorporated 5// All Rights Reserved. 6// 7// NOTICE: Adobe permits you to use, modify, and distribute this file 8// in accordance with the terms of the license agreement accompanying it. 9// 10//////////////////////////////////////////////////////////////////////////////// 11 12package mx.core 13{ 14 15/** 16 * The ContainerCreationPolicy class defines the constant values 17 * for the <code>creationPolicy</code> property of the Container class. 18 * 19 * @see mx.core.Container#creationPolicy 20 * 21 * @langversion 3.0 22 * @playerversion Flash 9 23 * @playerversion AIR 1.1 24 * @productversion Flex 3 25 */ 26public final class ContainerCreationPolicy 27{ 28 include "../core/Version.as"; 29 30 //-------------------------------------------------------------------------- 31 // 32 // Class constants 33 // 34 //-------------------------------------------------------------------------- 35 36 /** 37 * Delay creating some or all descendants until they are needed. 38 * 39 * <p>For example, if a navigator container such as a TabNavigator 40 * has this <code>creationPolicy</code>, it will immediately create 41 * all of its children, plus the descendants of the initially 42 * selected child. 43 * However, it will wait to create the descendants of the other children 44 * until the user navigates to them.</p> 45 * 46 * @langversion 3.0 47 * @playerversion Flash 9 48 * @playerversion AIR 1.1 49 * @productversion Flex 3 50 */ 51 public static const AUTO:String = "auto"; 52 53 /** 54 * Immediately create all descendants. 55 * 56 * <p>Avoid using this <code>creationPolicy</code> because 57 * it increases the startup time of your application. 58 * There is usually no good reason to create components at startup 59 * which the user cannot see. 60 * If you are using this policy so that you can "push" data into 61 * hidden components at startup, you should instead design your 62 * application so that the data is stored in data variables 63 * and components which are created later "pull" in this data, 64 * via databinding or an <code>initialize</code> handler.</p> 65 * 66 * @langversion 3.0 67 * @playerversion Flash 9 68 * @playerversion AIR 1.1 69 * @productversion Flex 3 70 */ 71 public static const ALL:String = "all"; 72 73 /** 74 * Add the container to a creation queue. 75 * Deprecated since Flex 4.0. 76 * 77 * @langversion 3.0 78 * @playerversion Flash 9 79 * @playerversion AIR 1.1 80 * @productversion Flex 3 81 */ 82 public static const QUEUED:String = "queued"; 83 84 /** 85 * Do not create any children. 86 * 87 * <p>With this <code>creationPolicy</code>, it is the developer's 88 * responsibility to programmatically create the children 89 * from the UIComponentDescriptors by calling 90 * <code>createComponentsFromDescriptors()</code> 91 * on the parent container.</p> 92 * 93 * @langversion 3.0 94 * @playerversion Flash 9 95 * @playerversion AIR 1.1 96 * @productversion Flex 3 97 */ 98 public static const NONE:String = "none"; 99} 100 101} 102