Класс GroupLayout.ParallelGroup

public sealed class GroupLayout.ParallelGroup extends GroupLayout.Group

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

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

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

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

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

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

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

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

Группа ParallelGroup без выравнивания по базовой линии

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

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

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