Класс GroupLayout.ParallelGroup

public class GroupLayout.ParallelGroup
extends GroupLayout.Group

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

Базовая линия

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

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

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

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

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

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

Небазовые ParallelGroup

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

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

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

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

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

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