Класс 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.