JavaTM Platform
Standard Ed. 6

javax.swing
类 GroupLayout.Group

java.lang.Object
  继承者 javax.swing.GroupLayout.Group
直接已知子类:
GroupLayout.ParallelGroup, GroupLayout.SequentialGroup
正在封闭类:
GroupLayout

public abstract class GroupLayout.Group
extends Object

GroupGroupLayout 所支持的以下两种操作提供基础:一个接一个地布置组件(SequentialGroup)或对齐组件(ParallelGroup)。Group 及其子类没有公共的构造方法;要创建一个 Group,请使用 createSequentialGroupcreateParallelGroup。此外,将从某个 GroupLayout 创建的 Group 与另一个 GroupLayout 一起使用将产生不确定的结果。

Group 及其子类中的各种方法允许显式地指定范围。这些方法的参数可以有两种形式:一个大于等于 0 的值,或者 DEFAULT_SIZEPREFERRED_SIZE 之一。大于等于 0 的值指示一个特定大小。DEFAULT_SIZE 指示应该使用取自组件的相应大小。例如,如果 DEFAULT_SIZE 作为最小大小参数传递,则最小大小是在组件上调用 getMinimumSize 获得的。同样,PREFERRED_SIZE 指示应该使用 getPreferredSize 返回的值。下面的例子将 myComponent 添加到 group,并带有特定的范围值。也就是说,最小值被显式地指定为 100,首选值为 200,最大值为 300。

group.addComponent(myComponent, 100, 200, 300);
 
下面的例子将 myComponent 添加到 group,并使用了各种形式的组合。强制使最小大小与首选大小相同,首选大小通过使用 myComponent.getPreferredSize 确定,最大大小通过对组件调用 getMaximumSize 确定。
group.addComponent(myComponent, GroupLayout.PREFERRED_SIZE,
GroupLayout.PREFERRED_SIZE, GroupLayout.DEFAULT_SIZE);
 

除非另行指定,否则只要传递了无效的范围,Group 及其子类的所有允许指定范围的方法都将抛出 IllegalArgumentException。无效范围是指,此范围内的任何值都小于 0 且不是 PREFERRED_SIZEDEFAULT_SIZE 之一,或是不满足以下条件的范围(对于特定值):min <= pref <= max

类似地,如果传递了 null,那么带有 Component 的所有方法都将抛出 NullPointerException,带有 Group 的所有方法都将抛出 IllegalArgumentException

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

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

方法详细信息

addGroup

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

参数:
group - 要添加的 Group
返回:
Group

addComponent

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

参数:
component - 要添加的 Component
返回:
Group

addComponent

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

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

addGap

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

参数:
size - 间隙的大小
返回:
Group
抛出:
IllegalArgumentException - 如果 size 小于 0

addGap

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

参数:
min - 间隙的最小大小
pref - 间隙的首选大小
max - 间隙的最大大小
返回:
Group
抛出:
IllegalArgumentException - 如果任一值小于 0

JavaTM Platform
Standard Ed. 6

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

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