模块 java.desktop

类 GroupLayout.ParallelGroup

java.lang.Object
javax.swing.GroupLayout.Group
javax.swing.GroupLayout.ParallelGroup
封闭类:
GroupLayout

public sealed class GroupLayout.ParallelGroup extends GroupLayout.Group
一个 Group 对齐和调整它的孩子。 ParallelGroup 以四种可能的方式对齐其子项:沿基线、居中、锚定到前缘或锚定到后缘。

基线

沿基线对齐其子项的 ParallelGroup 必须首先确定基线的锚定位置。基线可以锚定到组的顶部,也可以锚定到组的底部。即,基线与分组起点之间的距离可以是恒定距离,或者分组终点与基线之间的距离可以是恒定距离。可能的选择对应于 BaselineResizeBehavior 常量 CONSTANT_ASCENT CONSTANT_DESCENT

基线锚点可以通过createBaselineGroup方法显式指定,也可以根据元素确定。如果未明确指定,如果所有具有基线且与基线对齐的元素具有 CONSTANT_DESCENT 的基线调整大小行为,则基线将锚定到底部;否则基线被锚定到组的顶部。

如果元素具有 CONSTANT_ASCENTCONSTANT_DESCENT 的基线调整大小行为,则与基线对齐的元素可调整大小。基线大小调整行为为 OTHERCENTER_OFFSET 的元素不可调整大小。

基线是根据具有基线的每个元素的首选高度计算的。使用以下算法计算基线:max(maxNonBaselineHeight, maxAscent + maxDescent),其中 maxNonBaselineHeight 是所有没有基线或未沿基线对齐的元素的最大高度。 maxAscent 是具有基线并沿基线对齐的所有元素的最大上升(基线)。 maxDescent 是具有基线并沿基线对齐的所有元素的最大下降(首选高度 - 基线)。

沿基线对齐其元素的 ParallelGroup 仅在垂直轴上有用。如果您创建基线组并沿水平轴使用它,则在您向 GroupLayout 询问最小、首选或最大尺寸或尝试布局组件时抛出 IllegalStateException

未与基线对齐且小于 ParallelGroup 大小的元素以三种方式之一定位:居中、锚定到前缘或锚定到后缘。

非基线ParallelGroup

ParallelGroup s 使用 BASELINE 以外的对齐方式创建,以三种方式之一对齐小于组大小的元素:居中、锚定到前缘或锚定到后缘。

前缘基于轴和 ComponentOrientation 。对于垂直轴,顶边始终是前沿,底边始终是后沿。当 ComponentOrientation LEFT_TO_RIGHT 时,前缘为左边缘,后缘为右边缘。 RIGHT_TO_LEFTComponentOrientation 翻转左右边缘。子元素根据添加元素时指定的对齐方式对齐。如果不指定对齐方式,则使用为 ParallelGroup 指定的对齐方式。

要沿基线对齐元素,您可以使用 createBaselineGroupcreateParallelGroup 对齐 BASELINE。如果组不是使用基线对齐创建的,并且您尝试添加指定基线对齐的元素,则会抛出 IllegalArgumentException

自从:
1.6
参见: