Класс GroupLayout.Group

public abstract sealed class GroupLayout.Group extends Object permits GroupLayout.ParallelGroup, GroupLayout.SequentialGroup

Group служит основой для двух типов операций, поддерживаемых GroupLayout: размещения компонентов друг за другом (SequentialGroup) или с выравниванием (ParallelGroup). У Group и его подклассов нет открытого конструктора; чтобы создать экземпляр, используйте один из методов createSequentialGroup или createParallelGroup. Кроме того, использование Group, созданного одним экземпляром GroupLayout, с другим экземпляром приведёт к неопределённым результатам.

Различные методы в Group и его подклассах позволяют явно указать диапазон. Аргументы этих методов могут иметь одну из двух форм: значение, большее или равное 0, либо одно из DEFAULT_SIZE или PREFERRED_SIZE. Значение, большее или равное 0, указывает конкретный размер. DEFAULT_SIZE означает, что следует использовать соответствующий размер компонента. Например, если в качестве аргумента минимального размера передано DEFAULT_SIZE, минимальный размер определяется вызовом getMinimumSize для компонента. Аналогично, PREFERRED_SIZE означает, что следует использовать значение из getPreferredSize. В следующем примере в group добавляется myComponent с конкретными значениями диапазона. То есть минимальный размер явно задан равным 100, предпочтительный — 200, а максимальный — 300.

  group.addComponent(myComponent, 100, 200, 300);

В следующем примере в group добавляется myComponent с использованием комбинации этих форм. Минимальный размер принудительно устанавливается равным предпочтительному, предпочтительный размер определяется с помощью 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, выбрасывают IllegalArgumentException, если передано null, а любые методы, принимающие Group, выбрасывают NullPointerException, если передано null.