模块  java.desktop
软件包  javax.swing

Class GroupLayout.Group

  • 已知直接子类：
    GroupLayout.ParallelGroup ， GroupLayout.SequentialGroup
    Enclosing class:
    GroupLayout 
    public abstract class GroupLayout.Groupextends 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()

    • 方法详细信息

      • 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 min,                                int pref,                                int max)
        使用指定的大小为此 Group添加间隙。
        参数
        min - 间隙的最小尺寸
        pref - 间隙的首选大小
        max - 间隙的最大大小
        结果
        这 Group
        异常
        IllegalArgumentException - 如果任何值小于 0