Класс 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. В следующем примере 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.