Класс 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, что означает, что вертикальный центр компонента должен иметь ту же вертикальную координату, что и вертикальные центры других компонентов с вертикальным выравниванием 0,5.

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

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

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

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