JavaTM 2 Platform
Standard Ed. 5.0

javax.swing
クラス Box

java.lang.Object
  上位を拡張 java.awt.Component
      上位を拡張 java.awt.Container
          上位を拡張 javax.swing.JComponent
              上位を拡張 javax.swing.Box
すべての実装されたインタフェース:
ImageObserver, MenuContainer, Serializable, Accessible

public class Box
extends JComponent
implements Accessible

BoxLayout オブジェクトをレイアウトマネージャとして使う軽量なコンテナです。Box には、BoxLayout を使うコンテナまたは Box ではないコンテナにも便利なクラスメソッドがいくつか用意されています。

Box クラスは、レイアウトに影響する数種類の不可視コンポーネントを作成できます。たとえば、接着剤 (glue)、柱 (strut)、および固定領域 (rigid area) です。Box に含まれるすべてのコンポーネントのサイズが固定されている場合は、createGlue が返す接着剤コンポーネントを使って、コンポーネントの位置を制御できます。2 つのコンポーネントの間に一定の空間が必要な場合は、柱を使ってみることをお勧めします (createHorizontalStrut または createVerticalStrut)。常に同じ量の空間を占める不可視コンポーネントが必要な場合は、createRigidArea を呼び出すことで、そのコンポーネントを取得します。

BoxLayout を実装している場合、詳細な情報と例については、「The Java Tutorial」「How to Use BoxLayout」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降は、java.beans パッケージですべての JavaBeans の長期記憶がサポートされます。XMLEncoder を参照してください。

関連項目:
BoxLayout

入れ子のクラスの概要
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.BltBufferStrategy, Component.FlipBufferStrategy
 
フィールドの概要
protected  AccessibleContext accessibleContext
          現在設定されている AccessibleContext オブジェクトです。
 
クラス 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 から継承されたフィールド
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()
          不可視の接着剤コンポーネントを作成します。
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 を返します。
 void setLayout(LayoutManager l)
          AWTError をスローします。
 
クラス javax.swing.JComponent から継承されたメソッド
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, 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, transferFocusBackward, 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, 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, hide, 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, transferFocusUpCycle
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

accessibleContext

protected AccessibleContext accessibleContext
現在設定されている AccessibleContext オブジェクトです。

コンストラクタの詳細

Box

public Box(int axis)
指定された軸に沿ってコンポーネントを並べる Box を生成します。

パラメータ:
axis - BoxLayout.X_AXISBoxLayout.Y_AXISBoxLayout.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)
不可視の固定幅コンポーネントを生成します。水平ボックスでは、このメソッドを使って、2 つのコンポーネントの間隔を固定できます。垂直ボックスでは、このメソッドを使って、ボックスの幅を指定できます。不可視コンポーネントは、空間が余っていない限り高さがありません。空間が余っていれば、高さの最大値の指定がないコンポーネントと同様に、自身に必要な分の空間を占めます。

パラメータ:
width - 不可視コンポーネントのピクセル単位の幅。値はゼロ以上
戻り値:
コンポーネント
関連項目:
createVerticalStrut(int), createGlue(), createRigidArea(java.awt.Dimension)

createVerticalStrut

public static Component createVerticalStrut(int height)
不可視の、高さが固定されたコンポーネントを作成します。垂直ボックスでは、このメソッドを使って、2 つのコンポーネントの間隔を固定できます。水平ボックスでは、このメソッドを使って、ボックスの幅を指定できます。不可視コンポーネントは、空間が余っていない限り幅がありません。空間が余っていれば、幅の最大値の指定がないコンポーネントと同様に、自身に必要な分の空間を占めます。

パラメータ:
height - 不可視コンポーネントのピクセル単位の高さ。値はゼロ以上
戻り値:
コンポーネント
関連項目:
createHorizontalStrut(int), createGlue(), createRigidArea(java.awt.Dimension)

createGlue

public static Component createGlue()
不可視の接着剤コンポーネントを作成します。これは、可視コンポーネントに水平ボックスに対する最大幅や垂直ボックスに対する最大高が指定されているボックスに便利です。接着剤コンポーネントは、隣り合うコンポーネントの間隔を埋めるために必要なだけ延びる、糊のようなものと考えることができます。

たとえば、1 つの水平ボックスに、固定サイズのコンポーネントが 2 つ含まれているとします。このボックスに空間が追加されても、固定サイズコンポーネントは大きくなりません。このとき、接着剤がない場合、2 番目のコンポーネントの右の空間が余ります。ここで接着剤を固定サイズコンポーネントの間に置くと、余った空間を接着剤コンポーネントが占めます。接着剤を 1 番目の固定サイズコンポーネントの前に置くと、余った空間を接着剤コンポーネントが占め、2 つの固定サイズコンポーネントはボックスの右に寄せられます。1 番目の固定サイズコンポーネントの前、および 2 番目の固定サイズコンポーネントのあとに接着剤を置くと、2 つの固定サイズコンポーネントはボックスの中央に寄せられます。

接着剤を使うには、Box.createGlue を呼び出して、返されたコンポーネントをコンテナに追加します。接着剤コンポーネントには、最小のサイズ、あるいは適切なサイズがありません。そのため、余分な空間がない限り、空間を占めることはありません。余分な空間があれば、接着剤コンポーネントは、水平方向、または垂直方向の利用可能な空間を占めます。これは、幅あるいは高さの最大値の指定がないコンポーネントと同様です。

戻り値:
コンポーネント

createHorizontalGlue

public static Component createHorizontalGlue()
水平方向の接着剤コンポーネントを作成します。

戻り値:
コンポーネント

createVerticalGlue

public static Component createVerticalGlue()
垂直方向の接着剤コンポーネントを作成します。

戻り値:
コンポーネント

setLayout

public void setLayout(LayoutManager l)
AWTError をスローします。ボックスは、BoxLayout だけを使用できます。

オーバーライド:
クラス Container 内の setLayout
パラメータ:
l - 使用するレイアウトマネージャ
関連項目:
Container.doLayout(), Container.getLayout()

getAccessibleContext

public AccessibleContext getAccessibleContext()
このボックスに関連した AccessibleContext を返します。ボックスの場合、AccessibleContext は AccessibleBox の形式を取ります。必要に応じて新規の AccessibleAWTBox インスタンスが生成されます。

定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
このボックスの AccessibleContext として機能する AccessibleBox

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。