此容器的创建策略。当容器继承其父容器的创建策略时，该属性将非常有用。

如果为 true，则在更改子项的位置或大小时完成度量和布局。如果为 false，则仅当在容器中添加或删除子项时才能执行度量和布局。

使用 Move 效果时，正在移动的组件周围的布局不会为了适合 Move 效果动画而进行重新调整。将容器的 autoLayout 属性设置为 true 对此行为没有任何影响。

将 autoLayout 属性设置为 false 时，Zoom 效果不起作用。

autoLayout 属性不适用于 Accordion 或 ViewStack 容器。

默认值为 true.

返回 EdgeMetrics 对象，它具有四个属性：left、top、right 和 bottom。各属性值等于边框某一侧的粗细（以像素为单位）。

与 viewMetrics 不同，此属性不会被 Container 的子类覆盖。

由 MXML 编译器生成的 UIComponentDescriptor 对象的 Array。

每个 UIComponentDescriptor 对象都包含在容器的 MXML 标签的某个子 MXML 标签中指定的信息。Array 中 UIComponentDescriptor 对象的顺序与子标签的顺序相同。在初始化期间，子描述符用于创建容器的子 UIComponent 对象及其 Repeater 对象，并赋予它们在 MXML 中指定的初始属性值、事件处理程序、效果等。

另请参见

如果此容器的子项的位置和/或大小扩展到此容器的边框之外，是否应用剪裁遮罩。如果为 false，则在将此容器的子项移动或调整到此容器的边框之外时，这些子项仍然可见。如果为 true，将剪掉此容器的子项。

如果 clipContent 为 false，则将对此容器禁用滚动并且不显示滚动条。如果 clipContent 为 true，则当容器的子项扩展到容器边框之外时通常会显示滚动条。有关控制滚动条外观的其它信息，请参阅 horizontalScrollPolicy 和 verticalScrollPolicy。

默认值为 true.

返回鼠标在内容坐标系中的 x 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

返回内容坐标系中鼠标的 y 位置。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。

容器使用内部内容窗格控制滚动。容器创建内容窗格时，creatingContentPane 为 true，以便忽略或阻止某些事件。

指定实例化和绘制容器子项的顺序。

仅当 creationPolicy 属性设置为 ContainerCreationPolicy.QUEUED 时，此属性才可用。否则，将忽略此属性。

默认值为 -1.

此 Container 的子项创建策略。ActionScript 值可以是 ContainerCreationPolicy.AUTO、ContainerCreationPolicy.ALL、ContainerCreationPolicy.NONE 或 ContainerCreationPolicy.QUEUED。MXML 值可以是 "auto"、"all"、"none" 或 "queued"。

如果没有为容器指定 creationPolicy，则该容器将继承其父项的 creationPolicy。如果没有为 Application 指定 creationPolicy，则默认为 ContainerCreationPolicy.AUTO。

ContainerCreationPolicy.AUTO 的 creationPolicy 意味着容器将延迟创建部分或全部后代，直到需要它们时为止。此进程称为延迟实例化。此策略能使启动时间达到最佳，因为最初只创建很少的 UIComponent。但是，当用户首次导航到应用程序的其它部分时，这将引入导航延迟。导航器容器（如 Accordion、TabNavigator 和 ViewStack）通过立即创建其所有子项实现 ContainerCreationPolicy.AUTO 策略，但要等到子项成为导航器容器的所选子项时才创建该子项的更深层的后代。

ContainerCreationPolicy.ALL 的 creationPolicy 意味着导航器容器会立即创建每个子项的更深层的后代，而不必等待选择该子项。对于单一视图容器（如 VBox 容器），ContainerCreationPolicy.AUTO 和 ContainerCreationPolicy.ALL 策略没有区别。

ContainerCreationPolicy.QUEUED 的 creationPolicy 意味着要将容器添加到创建队列，而不是立即进行实例化和绘制。应用程序处理列队容器时，将创建容器的子项，并等待创建子项后才前进到创建队列中的下一个容器。

ContainerCreationPolicy.NONE 的 creationPolicy 意味着容器不创建其子项。在这种情况下，由 MXML 作者负责通过调用 createComponentsFromDescriptors() 方法来创建子项。

当您在项目渲染器或项目编辑器中使用某个组件时，可借助 data 属性向该组件传递值。您通常使用数据绑定将 data 属性的字段绑定到此组件的某个属性。

不要以 MXML 方式设置此属性。

默认值为 null.

此属性可用作数据绑定的源。

另请参见

指定为容器的默认按钮的 Button 控件。当容器中的控件具有焦点时，按 Enter 键与单击此 Button 控件的效果相同。

默认值为 null.

按下水平滚动条中的向左或向右箭头按钮时要移动的像素数目。

默认值为 5.

此属性可用作数据绑定的源。

按下水平滚动条中的轨道时要移动的像素数目。值 0 表示将页面大小设计为全屏。

默认值为 0.

此属性可用作数据绑定的源。

此容器中使用的水平滚动栏。如果当前未显示水平滚动条，则此属性为 null。通常，无需直接访问此属性。操纵 horizontalScrollPolicy 和 horizontalScrollPosition 属性即可很好地控制滚动条。

指定水平滚动条是始终显示、始终不显示，还是在需要时自动添加。ActionScript 值可以是 ScrollPolicy.ON、ScrollPolicy.OFF 和 ScrollPolicy.AUTO。MXML 值可以是 "on"、"off" 和 "auto"。

将此属性设置为 ScrollPolicy.OFF 还可以防止 horizontalScrollPosition 属性起作用。

注意：此属性不适用于 ControlBar 容器。

如果 horizontalScrollPolicy 为 ScrollPolicy.AUTO，则以下所有条件均满足时将显示水平滚动条：

• 容器的某个子项扩展到容器的左边缘或右边缘之外。
• clipContent 属性为 true。
• 容器的宽度和高度足以容纳滚动条。

默认值为 ScrollPolicy.AUTO.

此属性可用作数据绑定的源。

水平滚动条的当前位置。此值等于可滚动表面的左边缘和当前可见表面最左侧的片段之间的距离（以像素为单位）。

默认值为 0.

此属性可用作数据绑定的源。

由某些导航器容器显示的图标的 Class，用于代表此 Container。

例如，如果此 Container 是 TabNavigator 的一个子项，则此图标将显示在相应的选项卡中。如果此 Container 是 Accordion 的一个子项，则此图标将显示在相应的标题中。

要将图标嵌入到 SWF 文件中，请使用 @Embed() MXML 编译器指令：

        icon="@Embed('filepath')"
      

图像可以是 JPEG、GIF、PNG、SVG 或 SWF 文件。

默认值为 null.

此属性可用作数据绑定的源。

由某些导航器容器显示的文本，用于代表此 Container。

例如，如果此 Container 是 TabNavigator 的一个子项，则此字符串将显示在相应的选项卡中。如果此 Container 是 Accordion 的一个子项，则此字符串将显示在相应的标题中。

默认值为 "".

此属性可用作数据绑定的源。

horizontalScrollPosition 属性的最大可能值。如果水平 scrollbar 不存在，则默认值为 0。

verticalScrollPosition 属性的最大可能值。如果垂直 scrollbar 不存在，则默认值为 0。

此容器中的子组件数。

子组件数最初等于在 MXML 中声明的子项数。在运行时，可以通过调用 addChild() 或 addChildAt() 添加新项，也可以通过调用 removeChild()、removeChildAt() 或 removeAllChildren() 删除现有子项。

容器中通常包含子组件，可以使用 Container.getChildAt() 方法和 Container.numChildren 属性枚举这些子组件。此外，容器可以包含样式元素和外观，如边框和背景。Flash Player 和 AIR 创建的子组件和外观之间没有任何差异。二者均可以使用播放器的 getChildAt() 方法和 numChildren 属性进行访问。但是，Container 类通过覆盖 getChildAt() 方法和 numChildren 属性（以及其它多个方法）可造成容器的子项是唯一的子组件的错觉。

如果您需要访问容器的所有子项（内容子项和外观），则需使用 rawChildren 属性上的方法和属性，而不是常规 Container 方法。例如，可使用 Container.rawChildren.getChildAt()) 方法。但是，如果容器为其子项创建了 ContentPane Sprite 对象，则 rawChildren 属性值将只计算 ContentPane，而不计算容器的子项。并非总能够确定容器何时包含 ContentPane。

注意：如果您调用 rawChildren 对象的 addChild 或 addChildAt 方法，则需在添加的组件上设置 tabEnabled = false。这可以防止用户跳位到所添加的仅可视组件。

按下垂直滚动条中的向上或向下箭头按钮或使用鼠标滚轮滚动时，要滚动的像素数目。

默认值为 5.

此属性可用作数据绑定的源。

按下垂直滚动条中的轨道时要滚动的像素数目。值 0 表示将页面大小设计为全屏。

默认值为 0.

此属性可用作数据绑定的源。

此容器中使用的垂直滚动栏。如果当前未显示垂直滚动条，则此属性为 null。通常，无需直接访问此属性。操纵 verticalScrollPolicy 和 verticalScrollPosition 属性应提供对滚动条的足够控制。

指定垂直滚动条是始终显示、始终不显示，还是在需要时自动添加。可能的值为 ScrollPolicy.ON、ScrollPolicy.OFF 和 ScrollPolicy.AUTO。MXML 值可以是 "on"、"off" 和 "auto"。

将此属性设置为 ScrollPolicy.OFF 还可以防止 verticalScrollPosition 属性起作用。

注意：此属性不适用于 ControlBar 容器。

如果 verticalScrollPolicy 为 ScrollPolicy.AUTO，则以下所有条件均满足时将显示垂直滚动条：

• 容器的某个子项扩展到容器的顶部边缘或底部边缘之外。
• clipContent 属性为 true。
• 容器的宽度和高度足以容纳滚动条。

默认值为 ScrollPolicy.AUTO.

此属性可用作数据绑定的源。

垂直滚动条的当前位置。此值等于可滚动表面的顶部边缘与当前可见表面的最顶部片段之间的距离（以像素为单位）。

默认值为 0.

此属性可用作数据绑定的源。

返回具有 left、top、right 和 bottom 四个属性的对象。每个属性的值分别等于容器边缘四周镶边（可视元素）的粗细。

镶边包括边框粗细。如果 horizontalScrollPolicy 或 verticalScrollPolicy 属性值为 ScrollPolicy.ON，则镶边还包括相应滚动条的粗细。如果滚动策略为 ScrollPolicy.AUTO，则即使显示滚动条，镶边度量也不包括滚动条粗细。

Container 的子类应覆盖此方法，以便在定位 Container 的子项时考虑其它镶边。例如，Panel 类的 viewMetrics 属性应返回一个对象，该对象的 top 属性包括 Panel 容器的标题栏的粗细。

返回具有 left、top、right 和 bottom 四个属性的对象。每个属性的值分别等于容器边缘四周镶边（可视元素）的粗细与对象边距的粗细之和。

镶边包括边框粗细。如果 horizontalScrollPolicy 或 verticalScrollPolicy 属性值为 ScrollPolicy.ON，则镶边还包括相应滚动条的粗细。如果滚动策略为 ScrollPolicy.AUTO，则即使显示滚动条，镶边度量也不包括滚动条粗细。

构造函数。

向此容器添加一个子 DisplayObject 子项。一个子项添加到其它现有子项的后面，以便添加的第一个子项使用索引 0，下一个子项使用索引 1，依此类推。

注意：尽管已将方法的 child 参数指定为 DisplayObject 类型，但此参数必须实现 IUIComponent 接口才能添加为容器的子项。所有 Flex 组件都要实现此接口。

子项从后向前分层。也就是说，如果子项重叠，则索引为 0 的子项位于最后方，而索引为 numChildren - 1 的子项位于最前方。这就意味着，新添加的子项的层次将位于现有子项之前。

参数

另请参见

向此容器添加一个子 DisplayObject 子项。该子项将被添加到指定的索引位置。

注意：尽管已将方法的 child 参数指定为 DisplayObject 类型，但此参数必须实现 IUIComponent 接口才能添加为容器的子项。所有 Flex 组件都要实现此接口。

子项从后向前分层。也就是说，如果子项重叠，则索引为 0 的子项位于最后方，而索引为 numChildren - 1 的子项位于最前方。这就意味着，新添加的子项的层次将位于现有子项之前。

如果要在其中添加新子项的索引已被旧子项占用，则新子项不会替换旧子项；此旧子项及其后的子项将“滑过”此位置，且各子项的索引值将增加 1。例如，假设 Container 包含子项（A、B、C），而您在索引为 1 处添加了 D。此时容器将包含（A、D、B、C）。如果希望替换旧子项，则必须先将其删除，再添加新子项。

参数

另请参见

供溶解效果在内部用来添加叠加层到容器的镶边。

将 Point 对象从内容坐标转换为全局坐标。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。全局坐标指定的像素位置随舞台的左上角，即应用窗口的最外侧边缘而变化。

参数

将 Point 对象由内容坐标转换为本地坐标。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。本地坐标指定的像素位置随组件的左上角而变化。

参数

如果需要容器的边框外观，但却不存在，则创建容器的边框外观。

提供一个 UIComponentDescriptor，创建相应的组件并将该组件添加为此 Container 的子项。

此方法将实例化新对象，但不将其添加到显示列表，因此默认情况下，屏幕上不显示该对象。要向显示列表添加新对象，请在调用 createComponentFromDescriptor() 方法后对该容器调用 validateNow() 方法，如以下示例所示：

      myVBox.createComponentFromDescriptor(myVBox.childDescriptors[0],false);
      myVBox.validateNow();
      

或者，可以对该容器调用 createComponentsFromDescriptors() 方法，以一次性创建所有组件。不需要在调用 createComponentsFromDescriptors() 方法之后调用 validateNow() 方法。

参数

另请参见

循环访问 childDescriptors Array，并对每个元素调用 createComponentFromDescriptor() 方法。

如果容器的 creationPolicy 属性的值为 ContainerCreationPolicy.ALL，则将在初始化序列期间自动调用此方法。

如果容器的 creationPolicy 值为 ContainerCreationPolicy.AUTO，则在容器的子项将变为可见时自动调用此方法。

如果容器的 creationPolicy 属性的值为 ContainerCreationPolicy.NONE，则当您希望创建此容器的子项时应调用此函数。

参数

执行此 Container 上的所有数据绑定。创建某个 Container 后，Flex 将自动调用此方法以执行其中包含目标的所有数据绑定。MXML 容器/绑定问题 (177074) 的解决方案：覆盖 Container.executeBindings()，以便在调用 BindingManager.executeBindings() 时首选 descriptor.document 而不是 parentDocument。这样，就应始终为使用描述符创建的实例提供正确行为，并将为使用程序创建的实例提供初始行为。（在后一种情况中，可能会出现错误，也可能不出现错误。）可能会针对更新程序 1 提供更完整的修补程序，以保证非 DI 方案和重设父级组件方案中的行为均正确。

参数

执行到此 Container 的子 UIComponent 对象的绑定。创建 Container 后，Flex 将立刻自动调用此方法。

参数

获取第 n 个子组件对象。

此方法返回的子项包括在 MXML 中声明的子项，以及使用 addChild() 或 addChildAt() 方法添加的子项。

参数

返回 name 属性为指定 String 的子项。

参数

获取特定子项的从零开始的索引。

容器的第一个子项（即：出现在 MXML 声明中的第一个子标签）使用索引 0，第二个子项使用索引 1，依此类推。容器子项的索引确定了其布置次序。例如，在 VBox 中，索引为 0 的子项位于最上方，索引为 1 的子项位于其下，等等。

如果通过调用 addChild() 方法添加子项，则新子项的索引等于现有子项中的最大索引加 1。您可以使用 addChildAt() 方法在指定的索引位置插入子项；此时，先前位于该索引位置的子项的索引，以及高于此位置的子项的索引，都将增加 1，以使所有索引都落在 0 到 (numChildren - 1) 这一范围内。

如果通过调用 removeChild() 或 removeChildAt() 方法删除子项，将调整剩余子项的索引，以使所有索引都落在 0 到 (numChildren - 1) 这一范围内。

如果 myView.getChildIndex(myChild) 返回 5，则 myView.getChildAt(5) 返回 myChild。

通过调用 setChildIndex() 方法可以更改子项的索引。

参数

返回由容器的内容子项组成的 DisplayObject 对象的 Array。此数组不包括用于实现容器的显示元素（如其边框和背景图像）的 DisplayObject。

另请参见

将 Point 对象由全局坐标转换为内容坐标。全局坐标指定的像素位置随舞台的左上角，即应用窗口的最外侧边缘而变化。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。

参数

通过设置此容器边框的位置和大小响应大小更改。此方法是一种高级方法，可在创建 Container 的子类时覆盖。

使用 addChild() 方法将容器添加到父容器时，以及调用容器的 invalidateDisplayList() 方法时，Flex 将调用 layoutChrome() 方法。

无论 autoLayout 属性的值是什么，都将调用 Container.layoutChrome() 方法。

Container.layoutChrome() 方法可设置 Container 容器边框的位置和大小。在 Container 的每个子类中，子类的 layoutChrome() 方法应调用 super.layoutChrome() 方法，以便适当定位边框。

参数

将 Point 对象由本地坐标转换为内容坐标。本地坐标指定的像素位置随组件的左上角而变化。内容坐标指定的像素位置随组件内容的左上角而变化，并包括组件的所有内容区域，甚至包括当前剪切掉但必须能够通过滚动组件访问的任何区域。您可以使用内容坐标系设置和获取使用绝对定位的容器中子项的位置。

参数

在此容器的子项列表中删除所有子项。

从此容器的子项列表中删除子 DisplayObject。所删除子项的 parent 属性将设置为 null。除非受到显式破坏，否则，子项将一直存在。如果将其添加到另一容器，将保留其上次的已知状态。

参数

从此容器的子项列表中删除指定索引位置的子 DisplayObject。所删除子项的 parent 属性将设置为 null。除非受到显式破坏，否则，子项将一直存在。如果将其添加到另一容器，将保留其上次的已知状态。

参数

基于 horizontalScrollPosition 和 verticalScrollPosition 属性，确定容器的内容区域相对于可查看区域的位置。可查看区域中未显示出的内容将被剪掉。此方法应由内容区域中包含滚动镶边的子类覆盖。

设置特定子项的索引。请参阅 getChildIndex() 方法了解子项索引的说明。

参数

通过设置此容器子项的位置和大小来响应大小更改。

有关 updateDisplayList() 方法的详细信息，请参阅 UIComponent.updateDisplayList() 方法。

Container.updateDisplayList() 方法可设置 Container 容器边框的位置和大小。在 Container 的每个子类中，子类的 updateDisplayList() 方法应调用 super.updateDisplayList() 方法，以便适当定位边框。

参数

另请参见

将子项添加到容器后调度。

调用 addChild() 或 addChildAt() 方法时调度 childAdd 事件。首次创建容器后，会对在 MXML 文件中声明的每个子组件自动调用 addChild() 方法。每次 Repeater 对象添加或删除子对象时，都会自动调用 addChildAt() 方法。应用程序开发人员也可以手动调用这些方法来添加新的子项。

发送此事件时，即已初始化子对象，但尚未计算其宽度和高度，并且尚未在屏幕上绘制子对象。如果希望在完全初始化并呈现子对象时通知您，则注册为子对象的 creationComplete 事件的侦听器。

事件对象的属性有下列值：

容器子项的索引（在容器子项中）发生更改后调度。仅对指定作为 setChildIndex() 方法参数的子项调度此事件；而对伴随调用 setChildIndex() 方法而发生索引更改的其它子项不会调度此事件。

调用 setChildIndex() 方法时，子项的索引将发生更改。

事件对象的属性有下列值：

删除容器的子项之前调度。

当调用下列任一方法时传送此事件：removeChild()、removeChildAt() 或 removeAllChildren()。

事件对象的属性有下列值：

当 data 属性更改时进行调度。

当容器在 List 组件或其它组件中用作渲染器时，将使用 data 属性将要显示的数据传递给该容器。

事件对象的属性有下列值：

当用户手动滚动容器时调度。

当使用鼠标（例如，单击滚动条的“向下”按钮）或键盘（例如，敲击向下箭头键）更改滚动位置时，调度此事件。但是，如果以编程方式更改滚动位置（例如，设置 horizontalScrollPosition 属性的值），则不会调度此事件。无论是手动还是以编程方式更改滚动位置，都将传送 viewChanged 事件。

调度此事件时，scrollbar 已经更新到新的位置，但此时并未移动容器的子对象以反映新的滚动位置。

事件对象的属性有下列值：