JavaTM Platform
Standard Ed. 6

javax.swing
类 GroupLayout.ParallelGroup

java.lang.Object
  继承者 javax.swing.GroupLayout.Group
      继承者 javax.swing.GroupLayout.ParallelGroup
正在封闭类:
GroupLayout

public class GroupLayout.ParallelGroup
     
extends GroupLayout.Group

一个 Group,它对齐其子元素并确定其大小。ParallelGroup 以四种可能的方式对齐其子元素:沿基线、居中、固定在前端、固定在尾端。

基线

使其子元素沿基线对齐的 ParallelGroup 必须首先确定基线固定的位置。基线可以固定在组的顶部或底部。也就是说,基线和组开始位置之间的距离可以是一个恒定距离,或者组结束位置和基线之间的距离可以是一个恒定距离。可能的选择对应于 BaselineResizeBehavior 常量 CONSTANT_ASCENTCONSTANT_DESCENT

基线锚点 (anchor) 可以由 createBaselineGroup 方法显式地指定,也可以根据元素来确定。如果没有显式地指定,那么如果所有带有基线以及向基线对齐的元素的基线调整大小行为都是 CONSTANT_DESCENT,则基线将固定在组的底部;否则,基线将固定在组的顶部。

如果向基线对齐的元素的基线调整大小行为是 CONSTANT_ASCENTCONSTANT_DESCENT,则它们是可调整大小的。基线调整大小行为是 OTHERCENTER_OFFSET 的元素是不可调整大小的。

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

使其元素沿基线对齐的 ParallelGroup 仅用于垂直轴。如果创建了一个基线组并沿水平轴使用它,那么在向 GroupLayout 请求最小大小、首选大小或最大大小,或者试图布置组件时,将抛出 IllegalStateException

没有向基线对齐并且大小小于 ParallelGroup 的元素以下面三种方式之一确定其位置:居中、固定在前端、固定在尾端。

无基线 ParallelGroup

BASELINE 以外的对齐方式创建的 ParallelGroup 将小于组大小的元素以下面三种方式之一进行对齐:居中、固定在前端、固定在尾端。

前端是基于轴和 ComponentOrientation 的。对于垂直轴,往往顶边缘是前端,底边缘是尾端。当 ComponentOrientationLEFT_TO_RIGHT 时,前端是左边缘,尾端是右边缘。ComponentOrientationRIGHT_TO_LEFT 时则前端是右边缘,尾端是左边缘。根据添加元素时所使用的指定对齐方式来对齐子元素。如果没有指定对齐方式,则使用为 ParallelGroup 指定的对齐方式。

要沿基线对齐元素,可以使用 BASELINE 对齐方式来 createBaselineGroupcreateParallelGroup。如果组不是使用基线对齐方式创建的,那么在试图添加一个指定基线对齐方式的元素时将抛出 IllegalArgumentException

从以下版本开始:
1.6
另请参见:
GroupLayout.createParallelGroup(), GroupLayout.createBaselineGroup(boolean,boolean)

方法摘要
 GroupLayout.ParallelGroup addComponent(Component component)
          将 Component 添加到此 Group
 GroupLayout.ParallelGroup addComponent(Component component, GroupLayout.Alignment alignment)
          使用指定的对齐方式将 Component 添加到此 ParallelGroup
 GroupLayout.ParallelGroup addComponent(Component component, GroupLayout.Alignment alignment, int min, int pref, int max)
          使用指定的对齐方式和大小将 Component 添加到此 ParallelGroup
 GroupLayout.ParallelGroup addComponent(Component component, int min, int pref, int max)
          使用指定大小将 Component 添加到此 Group
 GroupLayout.ParallelGroup addGap(int pref)
          将固定间隙添加到此 Group
 GroupLayout.ParallelGroup addGap(int min, int pref, int max)
          将指定大小的间隙添加到此 Group
 GroupLayout.ParallelGroup addGroup(GroupLayout.Alignment alignment, GroupLayout.Group group)
          使用指定的对齐方式将 Group 添加到此 ParallelGroup
 GroupLayout.ParallelGroup addGroup(GroupLayout.Group group)
          将 Group 添加到此 Group
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

方法详细信息

addGroup

public GroupLayout.ParallelGroup addGroup(GroupLayout.Group group)
Group 添加到此 Group

覆盖:
GroupLayout.Group 中的 addGroup
参数:
group - 要添加的 Group
返回:
Group

addComponent

public GroupLayout.ParallelGroup addComponent(Component component)
Component 添加到此 Group

覆盖:
GroupLayout.Group 中的 addComponent
参数:
component - 要添加的 Component
返回:
Group

addComponent

public GroupLayout.ParallelGroup addComponent(Component component,
                                              int min,
                                              int pref,
                                              int max)
使用指定大小将 Component 添加到此 Group

覆盖:
GroupLayout.Group 中的 addComponent
参数:
component - 要添加的 Component
min - 最小大小或者 DEFAULT_SIZEPREFERRED_SIZE 之一
pref - 首选大小或者 DEFAULT_SIZEPREFERRED_SIZE 之一
max - 最大大小或者 DEFAULT_SIZEPREFERRED_SIZE 之一
返回:
Group

addGap

public GroupLayout.ParallelGroup addGap(int pref)
将固定间隙添加到此 Group

覆盖:
GroupLayout.Group 中的 addGap
参数:
pref - 间隙的大小
返回:
Group

addGap

public GroupLayout.ParallelGroup addGap(int min,
                                        int pref,
                                        int max)
将指定大小的间隙添加到此 Group

覆盖:
GroupLayout.Group 中的 addGap
参数:
min - 间隙的最小大小
pref - 间隙的首选大小
max - 间隙的最大大小
返回:
Group

addGroup

public GroupLayout.ParallelGroup addGroup(GroupLayout.Alignment alignment,
                                          GroupLayout.Group group)
使用指定的对齐方式将 Group 添加到此 ParallelGroup。如果子元素小于 Group,则根据指定的对齐方式来对齐它。

参数:
alignment - 对齐方式
group - 要添加的 Group
返回:
ParallelGroup
抛出:
IllegalArgumentException - 如果 alignmentnull

addComponent

public GroupLayout.ParallelGroup addComponent(Component component,
                                              GroupLayout.Alignment alignment)
使用指定的对齐方式将 Component 添加到此 ParallelGroup

参数:
alignment - 对齐方式
group - 要添加的 Component
返回:
Group
抛出:
IllegalArgumentException - 如果 alignmentnull

addComponent

public GroupLayout.ParallelGroup addComponent(Component component,
                                              GroupLayout.Alignment alignment,
                                              int min,
                                              int pref,
                                              int max)
使用指定的对齐方式和大小将 Component 添加到此 ParallelGroup

参数:
alignment - 对齐方式
component - 要添加的 Component
min - 最小大小
pref - 首选大小
max - 最大大小
返回:
Group
抛出:
IllegalArgumentException - 如果 alignmentnull

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策