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 ContainerLayout class defines the constant values
17 *  for the <code>layout</code> property of container classes.
18 *
19 *  @see mx.containers.Panel#layout
20 *  @see mx.core.Application#layout
21 */
22public final class ContainerLayout
23{
24	include "../core/Version.as";
25
26	//--------------------------------------------------------------------------
27	//
28	//  Class constants
29	//
30	//--------------------------------------------------------------------------
31
32	/**
33	 *  Use absolute layout for the contents of this container.
34	 *  You are responsible for explicitly specifying the position
35	 *  of each child.
36	 *
37	 *  <p>The easiest way to do this is to specify
38	 *  the <code>x</code>, <code>y</code>, <code>width</code>,
39	 *  and <code>height</code> of each child.</p>
40	 *
41	 *  <p>The <code>width</code> and <code>height</code> can be specified
42	 *  as a percentage value in MXML.
43	 *  (In ActionScript you have to set the <code>percentWidth</code>
44	 *  and <code>percentHeight</code> properties.)</p>
45	 *
46	 *  <p>If you don't specify the <code>width</code> or
47	 *  <code>percentWidth</code> for a child,
48	 *  then its <code>measuredWidth</code>, as automatically determined
49	 *  by its <code>measure()</code> method, will be used.
50	 *  The same applies for its height.</p>
51	 *
52	 *  <p>As an alternative way of doing layout, you can use the anchor
53	 *  styles <code>left</code>, <code>top</code>, <code>right </code>,
54	 *  <code>bottom</code>, <code>horizontalCenter</code>,
55	 *  and <code>verticalCenter</code> on children to anchor them to
56	 *  the sides or the center of a container.</p>
57	 *
58	 *  <p>When you use absolute layout, the container's
59	 *  <code>paddingLeft</code>, <code>paddingTop</code>,
60	 *  <code>paddingRight</code>, <code>paddingBottom</code>,
61	 *  <code>horizontalGap</code>, <code>verticalGap</code>,
62	 *  <code>horizontalAlign</code>, and<code>verticalAlign</code>
63	 *  styles are ignored.</p>
64	 */
65	public static const ABSOLUTE:String = "absolute";
66
67	/**
68	 *  Use vertical layout for the contents of this container.
69	 *  The container will automatically place its children in a single column.
70	 *
71	 *  <p>If you don't specify the <code>width</code> or
72	 *  <code>percentWidth</code> for a child,
73	 *  then its <code>measuredWidth</code>, as automatically determined
74	 *  by its <code>measure()</code> method, is used.
75	 *  The same applies for its height.</p>
76	 *
77	 *  <p>You can control the spacing between children
78	 *  with the <code>verticalGap</code> style,
79	 *  and the alignment of the children
80	 *  with the <code>horizontalAlign</code> style.
81	 *  The <code>paddingLeft</code>, <code>paddingTop</code>,
82	 *  <code>paddingRight</code>, and <code>paddingBottom</code> styles
83	 *  control the space between the border of the container
84	 *  and the children.</p>
85	 */
86	public static const VERTICAL:String = "vertical";
87
88	/**
89	 *  Use horizontal layout for the contents of this container.
90	 *  The container will automatically place its children in a single row.
91	 *
92	 *  <p>If you don't specify the <code>width</code> or
93	 *  <code>percentWidth</code> for a child,
94	 *  then its <code>measuredWidth</code>, as automatically determined
95	 *  by its <code>measure()</code> method, is used.
96	 *  The same applies for its height.</p>
97	 *
98	 *  <p>You can control the spacing between children
99	 *  with the <code>horizontalGap</code> style,
100	 *  and the alignment of the children
101	 *  with the <code>verticalAlign</code> style.
102	 *  The <code>paddingLeft</code>, <code>paddingTop</code>,
103	 *  <code>paddingRight</code>, and <code>paddingBottom</code> styles
104	 *  control the space between the border of the container
105	 *  and the children.</p>
106	 */
107	public static const HORIZONTAL:String = "horizontal";
108}
109
110}
111