Класс GroupLayout.ParallelGroup

public class GroupLayout.ParallelGroup
extends GroupLayout.Group

Группа, которая выравнивает и задаёт размеры своих дочерних элементов. Группа выравнивает дочерние элементы четырьмя возможными способами: по основанию, по центру, привязанными к ведущему краю или к заднему краю.

Основание

Группа, выравнивающая дочерние элементы по основанию, должна сначала определить, к чему привязано основание. Основание может быть привязано к верху или к низу группы. То есть, расстояние между основанием и началом группы может быть постоянным, или расстояние между концом группы и основанием может быть постоянным. Возможные варианты соответствуют константам BaselineResizeBehavior CONSTANT_ASCENT и CONSTANT_DESCENT.

Якорь основания может быть явно задан методом createBaselineGroup, или определён на основе элементов. Если не задан явно, основание будет привязано к низу, если все элементы с основанием, выровненные по основанию, имеют поведение изменения размера по основанию CONSTANT_DESCENT; в противном случае основание привязано к верху группы.

Элементы, выровненные по основанию, могут быть изменяемыми, если они имеют поведение изменения размера по основанию CONSTANT_ASCENT или CONSTANT_DESCENT. Элементы с поведением изменения размера по основанию OTHER или CENTER_OFFSET не изменяемы.

Основание вычисляется на основе предпочтительной высоты каждого из элементов, имеющих основание. Основание вычисляется по следующему алгоритму: max(maxNonBaselineHeight, maxAscent + maxDescent), где maxNonBaselineHeight — максимальная высота всех элементов, не имеющих основания или не выровненных по основанию. maxAscent — максимальный подъем (основание) всех элементов, имеющих основание и выровненных по основанию. maxDescent — максимальный спуск (предпочтительная высота — основание) всех элементов, имеющих основание и выровненных по основанию.

Группа, выравнивающая элементы по основанию, полезна только по вертикальной оси. Если вы создаёте группу по основанию и используете её по горизонтали, при запросе минимального, предпочтительного или максимального размера или попытке выложить компоненты будет выброшено исключение IllegalStateException.

Элементы, не выровненные по основанию и имеющие размер меньше размера группы, располагаются одним из трёх способов: по центру, привязанными к ведущему краю или к заднему краю.

Не-основные ParallelGroup

Группы, созданные с выравниванием, отличным от BASELINE, выравнивают элементы, размер которых меньше размера группы, одним из трёх способов: по центру, привязанными к ведущему краю или к заднему краю.

Ведущий край определяется осью и ComponentOrientation. Для вертикальной оси ведущий край всегда верхний, а задний — нижний. Когда ось ComponentOrientation — LEFT_TO_RIGHT, ведущий край — левый, а задний — правый. Значение ComponentOrientation RIGHT_TO_LEFT меняет местами левый и правый края. Дочерние элементы выравниваются в соответствии со значением выравнивания, использованным при их добавлении. Если выравнивание не задано, используется выравнивание, заданное для ParallelGroup.

Чтобы выровнять элементы по основанию, необходимо createBaselineGroup, или createParallelGroup с выравниванием BASELINE. Если группа не создавалась с выравниванием по основанию, а вы пытаетесь добавить элемент, указав выравнивание по основанию, будет выброшено исключение IllegalArgumentException.

Методы

addGroup

public GroupLayout.ParallelGroup addGroup(GroupLayout.Group group)

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

Overrides:

addGroup в классе GroupLayout.Group

Параметры:

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

Возвращает:

этот Group

addComponent

public GroupLayout.ParallelGroup addComponent(Component component)

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

Overrides:

addComponent в классе GroupLayout.Group

Параметры:

component - добавляемый Component

Возвращает:

этот Group

addComponent

public GroupLayout.ParallelGroup addComponent(Component component,
                                              int min,
                                              int pref,
                                              int max)

Добавляет Component в этот Group с указанными размерами.

Overrides:

addComponent в классе GroupLayout.Group

Параметры:

component - добавляемый Component

min - минимальный размер или одно из DEFAULT_SIZE или PREFERRED_SIZE

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

max - максимальный размер или одно из DEFAULT_SIZE или PREFERRED_SIZE

Возвращает:

этот Group

addGap

public GroupLayout.ParallelGroup addGap(int pref)

Добавляет жёсткий зазор в этот Group.

Overrides:

addGap в классе GroupLayout.Group

Параметры:

pref - размер зазора

Возвращает:

этот Group

addGap

public GroupLayout.ParallelGroup addGap(int min,
                                        int pref,
                                        int max)

Добавляет зазор в этот Group с указанными размерами.

Overrides:

addGap в классе GroupLayout.Group

Параметры:

min - минимальный размер зазора

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

max - максимальный размер зазора

Возвращает:

этот Group

addGroup

public GroupLayout.ParallelGroup addGroup(GroupLayout.Alignment alignment,
                                          GroupLayout.Group group)

Добавляет Group в этот ParallelGroup с указанным выравниванием. Если дочерний элемент меньше, чем Group , он выравнивается в соответствии с указанным выравниванием.

Параметры:

alignment - выравнивание

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

Возвращает:

этот ParallelGroup

Исключения:

IllegalArgumentException - если alignment имеет значение null

addComponent

public GroupLayout.ParallelGroup addComponent(Component component,
                                              GroupLayout.Alignment alignment)

Добавляет Component в этот ParallelGroup с указанным выравниванием.

Параметры:

alignment - выравнивание

component - добавляемый Component

Возвращает:

этот Group

Исключения:

IllegalArgumentException - если alignment имеет значение null

addComponent

public GroupLayout.ParallelGroup addComponent(Component component,
                                              GroupLayout.Alignment alignment,
                                              int min,
                                              int pref,
                                              int max)

Добавляет Component в этот ParallelGroup с указанным выравниванием и размерами.

Параметры:

alignment - выравнивание

component - добавляемый Component

min - минимальный размер

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

max - максимальный размер

Возвращает:

этот Group

Исключения:

IllegalArgumentException - если alignment имеет значение null