Module  java.desktop
软件包  javax.swing

Class GroupLayout.Group

  • 已知直接子类:
    GroupLayout.ParallelGroupGroupLayout.SequentialGroup
    Enclosing class:
    GroupLayout


    public abstract class GroupLayout.Group
    extends Object
    GroupGroupLayout支持的两种操作提供GroupLayout :一个接一个地( SequentialGroup )或对齐( ParallelGroup )组成的组件。 Group及其子类没有公共构造函数; 创建一个使用一个createSequentialGroupcreateParallelGroup 另外,从一个Group创建的GroupLayout并将其与另一个使用它将产生未定义的结果。

    Group及其子类中的各种方法允许您明确指定范围。 这些方法的参数可以采用两种形式,大于或等于0的值,或DEFAULT_SIZEPREFERRED_SIZE 大于或等于0值表示特定大小。 DEFAULT_SIZE表示应该使用组件的相应尺寸。 例如,如果DEFAULT_SIZE作为最小大小参数传递,则通过调用getMinimumSize上的getMinimumSize获取最小大小。 同样地, PREFERRED_SIZE表示从值getPreferredSize应该被使用。 以下示例将myComponent添加到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_SIZEDEFAULT_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_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