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