Class 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.