Класс GroupLayout.Group

public abstract class GroupLayout.Group
extends Object

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.

Методы

addGroup

public GroupLayout.Group addGroup(GroupLayout.Group group)

Добавляет Group в этот Group.

Параметры:

group - добавляемый Group

Возвращает:

этот Group

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_SIZE или PREFERRED_SIZE

pref - предпочтительный размер или одно из DEFAULT_SIZE или PREFERRED_SIZE

max - максимальный размер или одно из DEFAULT_SIZE или PREFERRED_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