Класс Box

javax.swing.Box

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

@JavaBean(defaultProperty="accessibleContext") public class Box extends JComponent implements Accessible

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

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

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

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

Начиная с версии:

1.2

См. также:

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

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

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

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

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

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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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);

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

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 — размеры невидимого компонента

Возвращает:

компонент

См. также:

createHorizontalStrut

public static Component createHorizontalStrut(int width)

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

Параметры:

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

Возвращает:

компонент

См. также:

createVerticalStrut

public static Component createVerticalStrut(int height)

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

Параметры:

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

Возвращает:

компонент

См. также:

createGlue

public static Component createGlue()

Создает невидимый компонент-клей, который может быть полезен в 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 есть пользовательский интерфейс, метод вызывает реализацию суперкласса; в противном случае, если этот 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/Box.html