Класс 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.