模块 java.desktop

软件包 javax.swing

Class GroupLayout.Group

java.lang.Object

javax.swing.GroupLayout.Group

已知直接子类：

GroupLayout.ParallelGroup ， GroupLayout.SequentialGroup

Enclosing class:

GroupLayout

public abstract class GroupLayout.Group
extends Object

Group为GroupLayout支持的两种操作提供了基础：一个接一个地布置组件（ SequentialGroup ）或对齐（ ParallelGroup ）。 Group及其子类没有公共构造函数; 创建一个使用createSequentialGroup或createParallelGroup 。 此外，从一个Group创建GroupLayout并将其与另一个使用将产生未定义的结果。

Group及其子类中的各种方法允许您显式指定范围。 这些方法的参数可以采用两种形式，大于或等于0的值，或者DEFAULT_SIZE或PREFERRED_SIZE 。 大于或等于0值表示特定大小。 DEFAULT_SIZE表示应使用组件的相应大小。 例如，如果传递DEFAULT_SIZE作为最小大小参数，则通过在组件上调用getMinimumSize获得最小大小。 同样地， PREFERRED_SIZE表示从值getPreferredSize应该被使用。 以下示例将myComponent添加到group ，并为该范围group了特定值。 也就是说，最小值明确指定为100，优选指定为200，最大值指定为300。

  group.addComponent(myComponent, 100, 200, 300); 

以下示例使用表单的组合将myComponent添加到group 。 最小尺寸强制与首选尺寸相同，首选尺寸使用myComponent.getPreferredSize确定，最大尺寸通过调用getMaximumSize上的getMaximumSize确定。

  group.addComponent(myComponent, GroupLayout.PREFERRED_SIZE,
             GroupLayout.PREFERRED_SIZE, GroupLayout.DEFAULT_SIZE); 

除非另有说明，否则Group所有方法及其允许指定范围的子类如果传递的范围无效，则抛出IllegalArgumentException 。 无效范围是其中任何值<0且不是PREFERRED_SIZE或DEFAULT_SIZE之一，或者DEFAULT_SIZE以下条件（对于特定值）： min <= pref <= max 。

同样是采取任何方法Component抛出IllegalArgumentException如果通过null并采取任何方法Group抛出NullPointerException如果通过null 。

从以下版本开始：

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_SIZE或 PREFERRED_SIZE

pref - 首选大小或 DEFAULT_SIZE或 PREFERRED_SIZE

max - 最大尺寸或 DEFAULT_SIZE或 PREFERRED_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