Класс BoxLayout

public class BoxLayout
extends Object
implements LayoutManager2, Serializable

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

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

Управляющий элемент макета BoxLayout создается с параметром оси, определяющим тип выполняемого макета. Существует четыре варианта:

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

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

LINE_AXIS - Components are laid out the way words are laid out in a line, based on the container's ComponentOrientation property. If the container's ComponentOrientation is horizontal then components are laid out horizontally, otherwise they are laid out vertically. For horizontal orientations, if the container's ComponentOrientation is left to right then components are laid out left to right, otherwise they are laid out right to left. For vertical orientations components are always laid out from top to bottom.

PAGE_AXIS - Components are laid out the way text lines are laid out on a page, based on the container's ComponentOrientation property. If the container's ComponentOrientation is horizontal then components are laid out vertically, otherwise they are laid out horizontally. For horizontal orientations, if the container's ComponentOrientation is left to right then components are laid out left to right, otherwise they are laid out right to left. For vertical orientations components are always laid out from top to bottom.

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

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

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

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

Дополнительную информацию и примеры см. в Руководстве по использованию BoxLayout в Учебнике Java.

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