Box  - AS3 Flex

Box 容器设置其子项布局的方向。可能的 MXML 值包括 "horizontal" 和 "vertical"。ActionScript 中的值可能为 BoxDirection.HORIZONTAL 和 BoxDirection.VERTICAL。

默认值为 BoxDirection.VERTICAL。

此属性可用作数据绑定的源。修改此属性后，将调度 directionChanged 事件。

构造函数。

计算 Box 容器的默认大小、最小值以及最大值。

如果 Box 容器的 direction 属性设置为 BoxDirection.HORIZONTAL，则其 measuredWidth 属性是其所有子项的默认宽度之和加上边框粗细、左右填充以及各子项间的水平间距。measuredHeight 属性的值是其所有子项默认高度中的最大值与边框和填充空间之和。如果 Box 容器的 direction 属性设置为 BoxDirection.VERTICAL，这两个值将对调。

Box 容器的 minWidth 和 minHeight 属性的计算过程类似，都是取子项的最小宽度和最小高度的组合。如果子项的 width 属性是一个百分比值，则 Box 容器的最小宽度等于其子项的 minWidth 属性值。如果子项的 width 尚未设置或设为固定值，则子项不能进行缩放，因此 Box 容器的最小宽度等于该子项的 explicitWidth 属性的值。子项最小高度的计算过程与此类似。

不计算 Box 容器的 maxWidth 和 maxHeight 属性。假定 Box 容器不存在最大宽度和高度限制。

上述所有值都是 Box 容器的测量宽度和高度。用户可以通过显式为下列属性提供值来覆盖测量值：

• width
• height
• minWidth
• minHeight
• maxWidth
• maxHeight

您不应直接调用 measure() 方法。Flex LayoutManager 会在合适的时间调用此方法。启动应用程序时，Flex LayoutManager 将首先尝试测量包括子项和父项在内的所有组件，然后将其设置为最终大小。

此方法是在细分过程中使用的高级方法。如果覆盖此方法，则必须调用 super.measure() 方法或设置 measuredHeight 和 measuredWidth 属性，才能实现。您还可以选择设置下列属性：

• measuredMinWidth
• measuredMinHeight

这些属性对应于先前列出的布局属性，因此不再单独介绍。

用于将像素数目转换为相对于容器内容的百分比的方法。

只有在不更改容器大小或布局的情况下，百分比值才有效。调整大小和/或应用新布局后，此方法返回的值可能会失效。

应用此方法的一个示例是隐藏组件后将该组件的大小还原为特定的像素数目。

参数

设置 Box 容器中每个子项的大小和位置。

要了解用于 Box 容器的布局算法，请假设 Box 容器的方向是水平的。

Box 容器的所有子项并排放置在同一水平行上，每对相邻的子项之间相隔 horizontalGap 像素。最初，未设定明确指示的宽度值的子项的宽度设置为 measuredWidth 属性的值。

如果子项的 measuredWidth 属性值之和大于或小于 Box 容器的宽度，并且其中部分子项的 width 属性为百分比值，则将调整这些子项的大小，直到 Box 正好可以容纳所有子项。但是，所有子项都不会缩至小于其 minWidth 属性值，或增至大于其 maxWidth 属性值。在增大（或缩小）子项的过程中，将根据子项的 percentWidth 按比例添加（或减小）多余的空间。例如，将 percentWidth 设为 40％ 的子项所增加的大小是将 percentWidth 设置为 20％ 的子项的两倍，直至填充了所有可用空间或达到了指定大小。

在所有灵活子项都完成增减后，Flex 将检查所有子项的宽度之和是否符合 Box 容器的宽度。如果二者不相符，子项组将根据 Box 容器的 horizontalAlign 属性进行整体移动，以便子项与 Box 的左边缘对齐、与 Box 的右边缘对齐或者位于 Box 的中间部分。

为确定每个子项的高度，Flex 将检查子项的 height 属性值。如果尚未设定 height，则子项高度将设为其 measuredHeight 值。如果 height 设为某个像素值，将使用该值。如果 height 设为百分比值，则子项的高度将增减为符合 Box 的指定高度百分比；前提是子项的高度不会缩至小于其 minHeight 属性值，或增至大于其 maxHeight 属性值。

每个子项的垂直位置由 Box 容器的 verticalAlign 属性确定。所有子项都需要移动，以便与 Box 的顶部边缘或底部边缘对齐，或者位于 Box 的中间部分。

如果 Box 容器的 direction 为 vertical，则规则相同，但宽度和高度将对调。子项将放在同一垂直列上。

不应该直接调用此方法。Flex LayoutManager 会在合适的时间调用此方法。启动应用程序时，Flex LayoutManager 将对每个组件调用 updateDisplayList() 方法，从 Application 对象开始，依次向下。

此方法是在细分过程中使用的高级方法。如果覆盖此方法，则应调用 super.updateDisplayList() 方法，并对各个子项调用 move() 和 setActualSize() 方法来实现此效果。要执行布局，您应该从 unscaledWidth 和 unscaledHeight 属性中获取此容器的大小，而不是从 width 和 height 属性中进行获取。width 和 height 属性与此容器的 scaleX 和 scaleY 属性值无关。

参数