BasicLayout  - AS3 Flex

包	spark.layouts
类	public class BasicLayout
继承	BasicLayout LayoutBase OnDemandEventDispatcher Object
子类	StackLayout

注意：基于 Spark List 的控件（Spark List 控件及其子类，如 ButtonBar、ComboBox、DropDownList 和 TabBar）不支持 BasicLayout 类。不要将 BasicLayout 与基于 Spark List 的控件一起使用。

按元素支持的约束有 left、right、top、bottom、horizontalCenter、verticalCenter、baseline、percentWidth 和 percentHeight。始终将考虑元素的最小大小和最大大小。

容器的测量大小是根据元素、其约束和其首选大小进行计算的。容器的测量大小足够大，能够在满足元素约束的情况下以元素的首选大小容纳所有元素。

以下是如何计算测量大小的一些示例：

• 如果容器具有指定了 left 约束的单个元素，则容器的测量宽度将等于元素的首选宽度加上 left 约束的值。
• 如果容器具有指定了 percentWidth 的单个元素，则容器的测量宽度将等于元素的首选宽度。尽管元素的 percentWidth 并不直接计入这些计算中，但在调用 updateDisplayList() 方法期间将考虑它。
• 如果容器具有指定了 baseline 约束的单个元素，则容器的测量高度将等于元素的首选高度加上 baseline 再减去元素的 baselinePosition 属性的值。
• 如果容器具有指定了 verticalCenter 约束的单个元素，则容器的测量高度将等于元素的首选高度加上两倍的 verticalCenter 约束值。

在 updateDisplayList() 方法的调用过程中，元素的大小是根据按以下优先级顺序的规则确定的（始终会考虑元素的最小大小和最大大小）：

• 如果元素已设置 percentWidth 或 percentHeight，则会将其大小计算为可用大小的某个百分比，其中可用大小是容器大小减去任何 left、right、top 或 bottom 约束。
• 如果元素具有 left 约束和 right 约束，则会将其宽度设置为容器的宽度减去 left 约束和 right 约束。
• 如果元素具有 top 约束和 bottom 约束，则会将其高度设置为容器的高度减去 top 约束和 bottom 约束。
• 将元素设置为其首选宽度和/或高度。

BasicLayout 类计算大小的最小值，并将它作为子代最小大小的最大值：

1. 为容器中的每个子代确定它能够收缩到的最小大小：
   • 如果子代约束到父代的宽度或高度，那么子代可以收缩到它的最小宽度或高度。使用子代的最小大小。
   • 如果子代没有约束到父代，那么它将保持首选大小。使用子代的首选大小。
2. 从步骤 1 中查找大小的最大值。

因此，如果子代约束到父代，那么布局将使用子代的最小大小。否则，将使用子代的首选大小来计算容器的最小大小。

元素的位置是根据按以下优先级顺序的规则确定的：

• horizontalCenter 或 verticalCenter 约束指定容器中心与元素中心之间的距离。将 horizontalCenter 或 verticalCenter 约束设置为零，会使容器内的元素在水平或垂直方向上居中。
• 如果指定了元素的 baseline，则会在垂直方向上定位元素，以使其 baselinePosition（通常为其第一行文本的基线）与 baseline 约束对齐。
• 如果指定了元素的 top 或 left 约束，则会定位元素，使元素的布局界限的左上角从容器的左上角偏移指定的值。
• 如果指定了元素的 bottom 或 right 约束，则会定位元素，使元素的布局界限的右下角从容器的右下角偏移指定的值。
• 如果没有任何约束确定水平或垂直方向上的位置，则会根据元素的 x 坐标和 y 坐标定位元素。

容器的内容大小将计算为所有布局元素右下角的坐标的最大值。

显示 MXML 语法

隐藏 MXML 语法

  <s:BasicLayout/>