Класс GroupLayout

public class GroupLayout extends Object implements LayoutManager2

GroupLayout — это LayoutManager, который иерархически группирует компоненты для их позиционирования в Container. GroupLayout предназначен для использования с помощью билдеров, но также может быть реализован вручную. Группировка выполняется с помощью экземпляров класса Group. GroupLayout поддерживает два типа групп. Последовательная группа позиционирует свои дочерние элементы последовательно, один за другим. Параллельная группа выравнивает свои дочерние элементы одним из четырёх способов.

Каждая группа может содержать любое количество элементов, где элемент — это Group, Component, или разрыв. Разрыв можно рассматривать как невидимый компонент с минимальным, предпочтительным и максимальным размером. Кроме того, GroupLayout поддерживает предпочтительный разрыв, значение которого берётся из LayoutStyle.

Элементы подобны пружинам. Каждый элемент имеет диапазон, как указано минимальным, предпочтительным и максимальным размерами. У разрывов либо задан диапазон разработчиком, либо определён LayoutStyle. Диапазон для Component определяется методами Component's getMinimumSize, getPreferredSize и getMaximumSize. Кроме того, при добавлении Component можно указать определённый диапазон вместо диапазона компонента. Диапазон для Group определяется типом группы. Диапазон ParallelGroup — это максимальный из диапазонов его элементов. Диапазон SequentialGroup — это сумма диапазонов его элементов.

GroupLayout обрабатывает каждую ось независимо. То есть, существует группа, представляющая горизонтальную ось, и группа, представляющая вертикальную ось. Горизонтальная группа отвечает за определение минимального, предпочтительного и максимального размера по горизонтали, а также за установку координаты x и ширины содержащихся в ней компонентов. Вертикальная группа отвечает за определение минимального, предпочтительного и максимального размера по вертикали, а также за установку координаты y и высоты содержащихся в ней компонентов. Каждый Component должен существовать как в горизонтальной, так и в вертикальной группе, в противном случае при разметке или запросе минимального, предпочтительного или максимального размера будет выброшено исключение IllegalStateException .

На следующем рисунке показана последовательная группа по горизонтальной оси. Последовательная группа содержит три компонента. По вертикальной оси использовалась параллельная группа.

Чтобы подчеркнуть, что каждая ось обрабатывается независимо, на диаграмме показан диапазон каждой группы и каждого элемента вдоль каждой оси. Диапазон каждого компонента был спроецирован на оси, а группы отображены синим цветом (горизонталь) и красным (вертикаль). Для большей наглядности между элементами последовательной группы оставлен зазор.

Последовательная группа по горизонтальной оси отображается как сплошная синяя линия. Обратите внимание, что последовательная группа равна сумме содержащихся в ней дочерних элементов.

По вертикальной оси параллельная группа равна максимуму высоты каждого компонента. Поскольку все три компонента имеют одинаковую высоту, параллельная группа также имеет одинаковую высоту.

На следующем рисунке показаны те же три компонента, но с параллельной группой по горизонтали и последовательной группой по вертикали.

Так как c1 является наибольшим из трёх компонентов, размер параллельной группы устанавливается в c1. Поскольку c2 и c3 меньше c1, они выравниваются в соответствии с указанным для компонента выравниванием (если оно указано) или по умолчанию для параллельной группы. На диаграмме c2 и c3 были созданы с выравниванием LEADING. Если ориентация компонента была бы справа налево, c2 и c3 были бы расположены с противоположной стороны.

На следующем рисунке показана последовательная группа по обеим осям (горизонтали и вертикали).

GroupLayout предоставляет возможность вставлять разрывы между Component. Размер разрыва определяется экземпляром LayoutStyle. Это можно включить с помощью метода setAutoCreateGaps. Аналогично, вы можете использовать метод setAutoCreateContainerGaps для вставки разрывов между компонентами, которые примыкают к краю родительского контейнера и самому контейнеру.

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

   JComponent panel = ...;
   GroupLayout layout = new GroupLayout(panel);
   panel.setLayout(layout);

   // Turn on automatically adding gaps between components
   layout.setAutoCreateGaps(true);

   // Turn on automatically creating gaps between components that touch
   // the edge of the container and the container.
   layout.setAutoCreateContainerGaps(true);

   // Create a sequential group for the horizontal axis.

   GroupLayout.SequentialGroup hGroup = layout.createSequentialGroup();

   // The sequential group in turn contains two parallel groups.
   // One parallel group contains the labels, the other the text fields.
   // Putting the labels in a parallel group along the horizontal axis
   // positions them at the same x location.
   //
   // Variable indentation is used to reinforce the level of grouping.
   hGroup.addGroup(layout.createParallelGroup().
            addComponent(label1).addComponent(label2));
   hGroup.addGroup(layout.createParallelGroup().
            addComponent(tf1).addComponent(tf2));
   layout.setHorizontalGroup(hGroup);

   // Create a sequential group for the vertical axis.
   GroupLayout.SequentialGroup vGroup = layout.createSequentialGroup();

   // The sequential group contains two parallel groups that align
   // the contents along the baseline. The first parallel group contains
   // the first label and text field, and the second parallel group contains
   // the second label and text field. By using a sequential group
   // the labels and text fields are positioned vertically after one another.
   vGroup.addGroup(layout.createParallelGroup(Alignment.BASELINE).
            addComponent(label1).addComponent(tf1));
   vGroup.addGroup(layout.createParallelGroup(Alignment.BASELINE).
            addComponent(label2).addComponent(tf2));
   layout.setVerticalGroup(vGroup);
 

При запуске получится следующее.

Эта разметка состоит из следующего.

• Горизонтальная ось состоит из последовательной группы, содержащей две параллельные группы. Первая параллельная группа содержит метки, а вторая — текстовые поля.
• Вертикальная ось состоит из последовательной группы, содержащей две параллельные группы. Параллельные группы настроены на выравнивание своих компонентов по базовой линии. Первая параллельная группа содержит первую метку и первое текстовое поле, а вторая группа содержит вторую метку и второе текстовое поле.

Обратите внимание на несколько моментов в этом коде:

• Не нужно явно добавлять компоненты в контейнер; это делается косвенно с помощью одного из методов add класса Group.
• Различные методы add возвращают вызывающий объект. Это позволяет легко использовать цепочку вызовов. Например, group.addComponent(label1).addComponent(label2); эквивалентно group.addComponent(label1); group.addComponent(label2);.
• Нет публичных конструкторов для Group; вместо этого используйте методы создания в классе GroupLayout.