Класс Box

public class Box
extends JComponent
implements Accessible

Легковесный контейнер, использующий объект BoxLayout в качестве менеджера компоновки. Box предоставляет несколько методов класса, полезных для контейнеров, использующих BoxLayout, — даже для не-Box контейнеров.

Класс Box может создавать несколько видов невидимых компонентов, влияющих на компоновку: glue, struts и rigid areas. Если у всех компонентов, которые ваш Box содержит, есть фиксированный размер, вы можете использовать компонент glue (полученный методом createGlue) для управления позициями компонентов. Если вам нужен фиксированный размер пространства между двумя компонентами, используйте strut (createHorizontalStrut или createVerticalStrut). Если нужен невидимый компонент, всегда занимающий одинаковый размер, используйте createRigidArea.

Если вы реализуете BoxLayout, дополнительную информацию и примеры можно найти в Как использовать BoxLayout — разделе учебника Java.

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

Конструкторы

Box

public Box(int axis)

Создаёт Box, который отображает свои компоненты вдоль указанной оси.

Параметры:

axis - может быть BoxLayout.X_AXIS, BoxLayout.Y_AXIS, BoxLayout.LINE_AXIS или BoxLayout.PAGE_AXIS.

Исключения:

AWTError - если axis неверно

См. также:

createHorizontalBox(), createVerticalBox()

Методы

createHorizontalBox

public static Box createHorizontalBox()

Создаёт Box, который отображает свои компоненты слева направо. Если вам нужен Box, который учитывает ориентацию компонента, вам следует создать Box с помощью конструктора и передать BoxLayout.LINE_AXIS, например:

Box lineBox = new Box(BoxLayout.LINE_AXIS);

Возвращает:

коробку

createVerticalBox

public static Box createVerticalBox()

Создаёт Box, который отображает свои компоненты сверху вниз. Если вам нужен Box, который учитывает ориентацию компонента, вам следует создать Box с помощью конструктора и передать BoxLayout.PAGE_AXIS, например:

Box lineBox = new Box(BoxLayout.PAGE_AXIS);

Возвращает:

коробку

createRigidArea

public static Component createRigidArea(Dimension d)

Создаёт невидимый компонент всегда заданного размера.

Параметры:

d - размеры невидимого компонента

Возвращает:

компонент

См. также:

createGlue(), createHorizontalStrut(int), createVerticalStrut(int)

createHorizontalStrut

public static Component createHorizontalStrut(int width)

Создаёт невидимый компонент фиксированной ширины. В горизонтальной коробке этот метод обычно используется для принудительного создания определённого отступа между двумя компонентами. В вертикальной коробке этот метод может использоваться для принудительного задания минимальной ширины коробки. Невидимый компонент не имеет высоты, если не доступно свободное место, в противном случае он занимает свою долю доступного пространства, как и любой другой компонент без максимальной высоты.

Параметры:

width - ширина невидимого компонента в пикселях ≥ 0

Возвращает:

компонент

См. также:

createVerticalStrut(int), createGlue(), createRigidArea(java.awt.Dimension)

createVerticalStrut

public static Component createVerticalStrut(int height)

Создаёт невидимый компонент фиксированной высоты. В вертикальной коробке этот метод обычно используется для принудительного создания определённого отступа между двумя компонентами. В горизонтальной коробке этот метод может использоваться для принудительного задания минимальной высоты коробки. Невидимый компонент не имеет ширины, если не доступно свободное место, в противном случае он занимает свою долю доступного пространства, как и любой другой компонент без максимальной ширины.

Параметры:

height - высота невидимого компонента в пикселях ≥ 0

Возвращает:

компонент

См. также:

createHorizontalStrut(int), createGlue(), createRigidArea(java.awt.Dimension)

createGlue

public static Component createGlue()

Возвращает:

компонент

createHorizontalGlue

public static Component createHorizontalGlue()

Создаёт горизонтальный компонент клея.

Возвращает:

компонент

createVerticalGlue

public static Component createVerticalGlue()

Создаёт вертикальный компонент клея.

Возвращает:

компонент

setLayout

public void setLayout(LayoutManager l)

Вызывает ошибку AWTError, так как Box может использовать только BoxLayout.

Переопределяет:

setLayout в классе Container

Параметры:

l - менеджер компоновки для использования

См. также:

Container.doLayout(), Container.getLayout(), Container.invalidate()

paintComponent

protected void paintComponent(Graphics g)

Отрисовывает этот Box. Если у этого Box есть UI, этот метод вызывает реализацию родительского класса, иначе, если этот Box непрозрачный, то Graphics заполняется фоном.

Переопределяет:

paintComponent в классе JComponent

Параметры:

g - Graphics для отрисовки

Исключения:

NullPointerException - если g равно null

С:

1.6

См. также:

JComponent.paint(java.awt.Graphics), ComponentUI

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этой коробкой. Для коробок AccessibleContext имеет вид AccessibleBox. Если необходимо, создаётся новый AccessibleAWTBox.

Определено в:

getAccessibleContext в интерфейсе Accessible

Переопределяет:

getAccessibleContext в классе Component

Возвращает:

AccessibleBox, который служит AccessibleContext этой коробки