javax.swing

Class Box

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.Box

All Implemented Interfaces:

ImageObserver， MenuContainer， Serializable， Accessible

public class Box
extends JComponent
implements Accessible

一个轻量级容器使用BoxLayout对象作为它的布局管理器。箱提供使用BoxLayout甚至非盒容器容器是有用的几类方法。

的Box类可以创建无形成分影响几种布局：胶水、Struts、刚性区域。如果所有的组件，你Box包含有固定的大小，你可能想要使用一种胶部件（由createGlue）控制元件的位置。如果你需要一个固定的空间之间的两个组件，试着用一个支柱（createHorizontalStrut或createVerticalStrut）。如果你需要一个看不见的部分总是占据相同的空间，通过调用createRigidArea得到它。

如果你正在实施一个BoxLayout你可以在How to Use BoxLayout找到更多信息和示例，java教程中的一部分。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

另请参见：

BoxLayout

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	Box.AccessibleBox 这个类实现了对 Box类可访问性支持。
static class	Box.Filler 一个参与布局的轻量级组件的实现，但没有视图。

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

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

Field Summary

Fields inherited from class javax.swing.JComponent

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

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

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

构造方法摘要

构造方法

Constructor and Description
Box(int axis) 创建一个 Box显示组件沿指定的轴。

方法摘要

Modifier and Type	Method and Description
static Component	createGlue() 创建一个不可见的“胶水”组件，它可以在一个框中，其可见的组件有一个最大宽度（对于一个水平框）或高度（对于一个垂直框）。
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盒。
protected void	paintComponent(Graphics g) 这 Box涂料。
void	setLayout(LayoutManager l) 抛出一个awterror，因为盒子可以只使用BoxLayout。

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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, 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

Methods inherited from class 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

Methods inherited from class 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

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，例如：

箱linebox =新盒（箱布置。line_axis）；

结果

盒子

createVerticalBox

public static Box createVerticalBox()

创建一个 Box显示部件从上到下。如果你想要一个 Box尊重元件定位你应该创建 Box使用构造函数，通过 BoxLayout.PAGE_AXIS，例如：

箱linebox =新盒（箱布置。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()

创建一个不可见的“胶水”组件，它可以在一个框中，其可见的组件有一个最大宽度（对于一个水平框）或高度（对于一个垂直框）。你能想到的胶部件作为一个粘性物质扩大多达必要填补其相邻元件之间的空间。

例如，假设您有一个包含两个固定大小的组件的水平框。如果盒子得到额外的空间，固定大小的组件不会变大，所以额外的空间去哪里呢？如果没有胶水，额外的空间会进入第二个组件的右边。如果你把固定大小的组件之间的胶水，那么额外的空间就有了。如果你把胶水在第一个固定的大小的组件，额外的空间去那里，和固定大小的组件被推到盒子的右边边缘。如果在第一个固定尺寸的组件和第二个固定尺寸的组件后，在第二个固定大小的组件，固定大小的组件集中在盒子里。

使用胶水，叫Box.createGlue添加返回的组件到一个容器。胶组分没有最小或首选的大小，所以它不需要任何空间，除非多余的空间是可用的。如果多余的空间是可用的，那么胶组件需要它的可用的水平或垂直空间的份额，就像任何没有最大宽度或高度的其他组件一样。

结果

组件

createHorizontalGlue

public static Component createHorizontalGlue()

创建一个水平胶水组件。

结果

组件

createVerticalGlue

public static Component createVerticalGlue()

创建一个垂直的胶水组件。

结果

组件

setLayout

public void setLayout(LayoutManager l)

抛出一个awterror，因为盒子可以只使用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是空的

从以下版本开始：

一点六

另请参见：

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext盒。盒子的accessiblecontext，以一accessiblebox形式。一个新的accessibleawtbox实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 Component

结果

一个accessiblebox作为这个盒子的accessiblecontext