Класс GroupLayout.ParallelGroup

public class GroupLayout.ParallelGroup extends GroupLayout.Group

Группа, которая выравнивает и задаёт размеры своих дочерних элементов. 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

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

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

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