Module java.desktop
Package javax.swing

Class 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
参见:

  • Method Details

    • 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