Класс BoxLayout

public class BoxLayout extends Object implements LayoutManager2, Serializable

Менеджер компоновки, позволяющий размещать несколько компонентов либо вертикально, либо горизонтально. Компоненты не будут переносить на другую строку, поэтому, например, вертикальная компоновка компонентов останется вертикальной при изменении размеров фрейма.

Вложенность нескольких панелей с различными комбинациями горизонтальной и вертикальной компоновки обеспечивает эффект, похожий на GridBagLayout, но без сложности. Диаграмма показывает две панели, расположенные горизонтально, каждая из которых содержит 3 компонента, расположенных вертикально.

Менеджер BoxLayout создаётся с параметром оси, определяющим тип компоновки. Существует четыре варианта:

X_AXIS — Компоненты выстраиваются горизонтально слева направо.

Y_AXIS — Компоненты выстраиваются вертикально сверху вниз.

LINE_AXIS — Компоненты выстраиваются так же, как слова в строке, на основе свойства контейнера ComponentOrientation. Если ориентация контейнера ComponentOrientation горизонтальная, компоненты выстраиваются горизонтально; в противном случае — вертикально. Для горизонтальной ориентации, если ориентация контейнера ComponentOrientation слева направо, компоненты выстраиваются слева направо; в противном случае — справа налево. Для вертикальной ориентации компоненты всегда выстраиваются сверху вниз.

PAGE_AXIS — Компоненты выстраиваются так же, как строки текста на странице, на основе свойства контейнера ComponentOrientation. Если ориентация контейнера ComponentOrientation горизонтальная, компоненты выстраиваются вертикально; в противном случае — горизонтально. Для горизонтальной ориентации, если ориентация контейнера ComponentOrientation слева направо, компоненты выстраиваются слева направо; в противном случае — справа налево. Для вертикальной ориентации компоненты всегда выстраиваются сверху вниз.

Во всех направлениях компоненты размещаются в том же порядке, в котором они были добавлены в контейнер.

BoxLayout пытается разместить компоненты по их предпочтительным ширинам (для горизонтальной компоновки) или высотам (для вертикальной). Для горизонтальной компоновки, если не все компоненты имеют одинаковую высоту, BoxLayout пытается сделать все компоненты высотой, равной наибольшей высоте компонента. Если это невозможно для конкретного компонента, тогда BoxLayout выравнивает этот компонент вертикально в соответствии с вертикальным выравниванием компонента. По умолчанию вертикальное выравнивание компонента равно 0,5, что означает, что вертикальный центр компонента должен иметь ту же координату Y, что и вертикальные центры других компонентов с вертикальным выравниванием 0,5.

Аналогично, для вертикальной компоновки BoxLayout пытается сделать все компоненты в столбце шириной, равной наибольшей ширине компонента. Если это не удаётся, он выравнивает их по горизонтали в соответствии с их горизонтальными выравниваниями. Для компоновки PAGE_AXIS горизонтальное выравнивание выполняется на основе ведущего края компонента. Иными словами, значение горизонтального выравнивания 0,0 означает левый край компонента, если ориентация контейнера ComponentOrientation слева направо, и правый край компонента в противном случае.

Вместо прямого использования BoxLayout, многие программы используют класс Box. Класс Box — это лёгкий контейнер, использующий BoxLayout. Он также предоставляет удобные методы, помогающие использовать BoxLayout эффективно. Добавление компонентов в несколько вложенных блоков — мощный способ получить желаемое расположение.

Для получения дополнительной информации и примеров см. Как использовать BoxLayout, раздел в Java Tutorial.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. С версии 1.4 добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. XMLEncoder.