Класс GroupLayout.Group

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

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

Различные методы в 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, выбрасывают IllegalArgumentException при передаче null, а любые методы, принимающие Group, выбрасывают NullPointerException при передаче null.