模块 java.desktop
包 javax.swing

类 GroupLayout.Group

java.lang.Object
javax.swing.GroupLayout.Group
已知子类：
GroupLayout.ParallelGroup , GroupLayout.SequentialGroup
封闭类：
GroupLayout
public abstract sealed class GroupLayout.Group extends Object permits GroupLayout.ParallelGroup , GroupLayout.SequentialGroup
Group 为 GroupLayout 支持的两种类型的操作提供了基础：一个接一个地布置组件 (SequentialGroup ) 或对齐 (ParallelGroup )。 Group 及其子类没有公共构造函数；创建一个使用 createSequentialGroup 或 createParallelGroup 之一。此外，使用从一个 GroupLayout 创建的 Group 并将其与另一个一起使用将产生未定义的结果。

Group 及其子类中的各种方法允许您显式指定范围。这些方法的参数可以采用两种形式，要么是大于或等于 0 的值，要么是 DEFAULT_SIZE 或 PREFERRED_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_SIZE 或 DEFAULT_SIZE 之一，或者不满足以下条件（对于特定值）：min <= pref <= max 。

类似地，任何采用 Component 的方法在传递 null 时抛出 IllegalArgumentException，而任何采用 Group 的方法在传递 null 时抛出 NullPointerException。

自从：
1.6
参见：

  • 方法详情

    • 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