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

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

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

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

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