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

중첩(Nested) 클래스 개요

protected class	Box.AccessibleBox 이 클래스는 Box 클래스용의 사용자 보조 기능의 지원를 구현하고 있습니다.
static class	Box.Filler 레이아웃에 관련해, 뷰를 가지지 않는 경량 컴퍼넌트의 구현입니다.

클래스 javax.swing. JComponent 로부터 상속된 중첩(Nested) 클래스/인터페이스

JComponent.AccessibleJComponent

클래스 java.awt. Container 로부터 상속된 중첩(Nested) 클래스/인터페이스

Container.AccessibleAWTContainer

클래스 java.awt. Component 로부터 상속된 중첩(Nested) 클래스/인터페이스

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를 Throw 합니다.

클래스 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_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)

불가시의 고정폭컴퍼넌트를 생성합니다. 수평 박스에서는 이 메서드를 사용해, 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를 Throw 합니다. 박스는 BoxLayout 만을 사용할 수 있습니다.

오버라이드(override):

클래스 Container 내의 setLayout

파라미터:

l - 사용하는 레이아웃 매니저

관련 항목:

Container.doLayout(), Container.getLayout()

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 박스에 관련한 AccessibleContext를 리턴합니다. 박스의 경우, AccessibleContext는 AccessibleBox 형식을 취합니다. 필요에 따라서 새로운의 AccessibleAWTBox 인스턴스가 생성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 박스의 AccessibleContext 로서 기능하는 AccessibleBox