模块  java.desktop
软件包  javax.swing

Class GroupLayout.Group

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

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

    Group及其子类中的各种方法允许您显式指定范围。 这些方法的参数可以采用两种形式,大于或等于0的值,或者DEFAULT_SIZEPREFERRED_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_SIZEDEFAULT_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_SIZEPREFERRED_SIZE
        pref - 首选大小或 DEFAULT_SIZEPREFERRED_SIZE
        max - 最大尺寸或 DEFAULT_SIZEPREFERRED_SIZE
        结果
        Group
      • addGap

        public GroupLayout.Group addGap​(int min,
                                        int pref,
                                        int max)
        使用指定的大小为此 Group添加间隙。
        参数
        min - 间隙的最小尺寸
        pref - 间隙的首选大小
        max - 间隙的最大大小
        结果
        Group
        异常
        IllegalArgumentException - 如果任何值小于 0