Класс BoxLayout

public class BoxLayout extends Object implements LayoutManager2, Serializable

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

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

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

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

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

BoxLayout пытается разместить компоненты в соответствии с их предпочтительными ширинами (для горизонтальной компоновки) или высотами (для вертикальной компоновки).

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

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

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

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

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