Класс Box

javax.swing.Box

Все реализуемые интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible

@JavaBean(defaultProperty="accessibleContext") 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 Tutorial.

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

С:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`Box.AccessibleBox`	Этот класс реализует поддержку доступности для класса `Box`.
`static class`	`Box.Filler`	Реализация лёгкого компонента, участвующего в компоновке, но не имеющего представления.

Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent

JComponent.AccessibleJComponent

Вложенные классы/интерфейсы, объявленные в классе java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Поля, объявленные в классе javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, объявленные в классе java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Краткое описание конструкторов

Конструктор	Описание
`Box(int axis)`	Создаёт `Box`, отображающий компоненты вдоль указанной оси.

Краткое описание методов

Модификатор и тип	Метод	Описание
`static Component`	`createGlue()`	Создаёт невидимый компонент "glue", полезный в Box, у которого видимые компоненты имеют максимальную ширину (для горизонтального Box) или высоту (для вертикального Box).
`static Box`	`createHorizontalBox()`	Создаёт `Box`, отображающий компоненты слева направо.
`static Component`	`createHorizontalGlue()`	Создаёт горизонтальный компонент glue.
`static Component`	`createHorizontalStrut(int width)`	Создаёт невидимый компонент с фиксированной шириной.
`static Component`	`createRigidArea(Dimension d)`	Создаёт невидимый компонент с указанным размером.
`static Box`	`createVerticalBox()`	Создаёт `Box`, отображающий компоненты сверху вниз.
`static Component`	`createVerticalGlue()`	Создаёт вертикальный компонент glue.
`static Component`	`createVerticalStrut(int height)`	Создаёт невидимый компонент с фиксированной высотой.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим Box.
`protected void`	`paintComponent(Graphics g)`	Отрисовывает этот `Box`.
`void`	`setLayout(LayoutManager l)`	Выбрасывает AWTError, так как Box может использовать только BoxLayout.

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUI, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Методы, объявленные в классе java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Методы, объявленные в классе java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

Box

public Box(int axis)

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

Параметры:

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

Исключения:

AWTError — если axis некорректно

См. также:

Подробное описание методов

createHorizontalBox

public static Box createHorizontalBox()

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

   Box lineBox = new Box(BoxLayout.LINE_AXIS);

Возвращает:: объект Box

createVerticalBox

public static Box createVerticalBox()

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

   Box lineBox = new Box(BoxLayout.PAGE_AXIS);

Возвращает:: объект Box

createRigidArea

public static Component createRigidArea(Dimension d)

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

Параметры:

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

Возвращает:

компонент

См. также:

createHorizontalStrut

public static Component createHorizontalStrut(int width)

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

Параметры:

width — ширина невидимого компонента в пикселях, >= 0

Возвращает:

компонент

См. также:

createVerticalStrut

public static Component createVerticalStrut(int height)

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

Параметры:

height — высота невидимого компонента в пикселях, >= 0

Возвращает:

компонент

См. также:

createGlue

public static Component createGlue()

Создаёт невидимый компонент-«клей», который может быть полезен в Box, чьи видимые компоненты имеют максимальную ширину (для горизонтальной Box) или высоту (для вертикальной Box). Можно представить компонент-«клей» как тягучее вещество, которое расширяется по мере необходимости, чтобы заполнить пространство между соседними компонентами.

Например, предположим, что у вас есть горизонтальная Box, содержащая два компонента фиксированного размера. Если Box получает дополнительное пространство, компоненты фиксированного размера не увеличатся, так куда же девается дополнительное пространство? Без компонента-«клея» дополнительное пространство будет справа от второго компонента. Если вы поместите компонент-«клей» между компонентами фиксированного размера, тогда дополнительное пространство пойдёт туда. Если вы поместите компонент-«клей» перед первым компонентом фиксированного размера, дополнительное пространство пойдёт туда, и компоненты фиксированного размера будут прижаты к правому краю Box. Если вы поместите компонент-«клей» перед первым компонентом фиксированного размера и после второго компонента фиксированного размера, компоненты фиксированного размера будут центрированы в Box.

Для использования компонента-«клея», вызовите Box.createGlue и добавьте возвращаемый компонент в контейнер. Компонент-«клей» не имеет минимального или предпочтительного размера, поэтому он не занимает места, если нет избыточного пространства. Если избыточное пространство доступно, тогда компонент-«клей» занимает свою долю доступного горизонтального или вертикального пространства, как и любой другой компонент, у которого нет максимальной ширины или высоты.

Возвращает:: компонент

createHorizontalGlue

public static Component createHorizontalGlue()

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

Возвращает:: компонент

createVerticalGlue

public static Component createVerticalGlue()

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

Возвращает:: компонент

setLayout

public void setLayout(LayoutManager l)

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

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

setLayout в классе Container

Параметры:

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

См. также:

paintComponent

protected void paintComponent(Graphics g)

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

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

paintComponent в классе JComponent

Параметры:

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

Исключения:

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

С:

1.6

См. также:

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этой Box. Для Box AccessibleContext представлен в виде AccessibleBox. Новый экземпляр AccessibleAWTBox создаётся при необходимости.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleBox, который служит AccessibleContext этой Box

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/Box.html