javax.swing
클래스 JToolBar

java.lang.Object 
  |
  +--java.awt.Component 
        |
        +--java.awt.Container 
              |
              +--javax.swing.JComponent 
                    |
                    +--javax.swing.JToolBar

모든 구현 인터페이스:

Accessible , ImageObserver , MenuContainer , Serializable , SwingConstants

public class JToolBar

extends JComponent

implements SwingConstants , Accessible

JToolBar 는 일반적으로 사용되는 Action 또는 컨트롤을 표시하는데 도움이 되는 컴퍼넌트를 제공합니다. 툴바의 사용예 및 자세한 것은 「The Java Tutorial」의「How to Use Tool Bars」를 참조해 주세요.

대부분의 Look & Feel 에서는 floatable 프로퍼티가 false 로 설정되어 있지 않은 한, 유저가 툴바를 드러그 아웃 해, 다른 윈도우에 넣을 수가 있습니다. 드러그 아웃을 적절히 기능시키려면 , 레이아웃 매니저가 BorderLayout 인 컨테이너의 4 옆의 1 개에 JToolBar 의 인스턴스를 추가해, 그 이외의 옆에는 아이를 추가하지 않는 것을 추천합니다.

표준의 Look & Feel (L&F) 표현으로 이 컴퍼넌트가 사용하는 키보드의 키에 대해서는 JToolBar 의 키의 할당을 참조해 주세요.

경고: 이 클래스의 직렬화 된 오브젝트는 향후의 Swing 릴리스와 호환은 아니게 될 예정입니다. 현재의 직렬화의 서포트는 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. JDK 버젼 1.4 이후는 java.beans 패키지에 모든 JavaBeans^TM 의 장기 기억이 서포트됩니다. XMLEncoder 를 참조해 주세요.

관련 항목:

Action

중첩된 클래스의 개요

protected class	JToolBar.AccessibleJToolBar 이 클래스는 JToolBar 클래스용의 유저 보조 기능의 서포트를 구현하고 있습니다.
static class	JToolBar.Separator 툴바 독자적인 separator입니다.

클래스 javax.swing. JComponent 을 상속받은 중첩된 클래스

클래스 java.awt. Container 을 상속받은 중첩된 클래스

클래스 java.awt. Component 을 상속받은 중첩된 클래스

Component.BltBufferStrategy , Component.FlipBufferStrategy

필드의 개요

클래스 javax.swing. JComponent 에서 상속받은 필드

accessibleContext , 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

인터페이스 javax.swing. SwingConstants 에서 상속받은 필드

BOTTOM , CENTER , EAST , HORIZONTAL , LEADING , LEFT , NEXT , NORTH , NORTH_EAST , NORTH_WEST , PREVIOUS , RIGHT , SOUTH , SOUTH_EAST , SOUTH_WEST , TOP , TRAILING , VERTICAL , WEST

인터페이스 java.awt.image. ImageObserver 에서 상속받은 필드

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

생성자의 개요

JToolBar ()
새로운 툴바를 작성합니다.

JToolBar (int orientation)
orientation 를 지정해 새로운 툴바를 작성합니다.

JToolBar (String name)
name 를 지정해 신규의 툴바를 작성합니다.

JToolBar (String name, int orientation)
지정된 name 와 orientation 로 새로운 툴바를 작성합니다.

메소드의 개요

JButton	add (Action a) 액션을 디스팟치 하는 새로운 JButton 를 추가합니다.
protected void	addImpl (Component comp, Object constraints, int index) JButton 가 추가되면(자), 초기 상태에서는 사용 불가로 설정됩니다.
void	addSeparator () 디폴트 사이즈의 separator를 툴바의 종단에 추가합니다.
void	addSeparator (Dimension size) 지정된 사이즈의 separator를 툴바의 종단에 추가합니다.
protected PropertyChangeListener	createActionChangeListener (JButton b) Action 에의 변경이 발생하는 경우에 컨트롤을 갱신하기 위한 , 적절히 설정된 PropertyChangeListener 를 돌려줍니다.
protected JButton	createActionComponent (Action a) JToolBar 에 추가된 Action 의 JButton 를 작성하는 팩토리 메소드입니다.
AccessibleContext	getAccessibleContext () 이 JToolBar 에 관련한 AccessibleContext 를 돌려줍니다.
Component	getComponentAtIndex (int i) 지정된 인덱스의 컴퍼넌트를 돌려줍니다.
int	getComponentIndex (Component c) 지정된 컴퍼넌트의 인덱스를 돌려줍니다.
Insets	getMargin () 툴바의 보더와 그 버튼의 사이의 마진을 돌려줍니다.
int	getOrientation () 현재의 툴바의 방향을 돌려줍니다.
ToolBarUI	getUI () 툴바의 현재의 UI 를 돌려줍니다.
String	getUIClassID () 이 컴퍼넌트를 표현 하는 L&F 클래스의 이름을 돌려줍니다.
boolean	isBorderPainted () borderPainted 프로퍼티를 돌려줍니다.
boolean	isFloatable () floatable 프로퍼티를 돌려줍니다.
boolean	isRollover () 롤 오버 상태를 돌려줍니다.
protected void	paintBorder (Graphics g) BorderPainted 프로퍼티가 true 의 경우, pop-up menu의 보더를 paint 합니다.
protected String	paramString () 이 JToolBar 의 캐릭터 라인 표현을 돌려줍니다.
void	setBorderPainted (boolean b) borderPainted 프로퍼티를 설정합니다.
void	setFloatable (boolean b) floatable 프로퍼티를 설정합니다.
void	setLayout (LayoutManager mgr) 이 컨테이너의 레이아웃 매니저를 설정합니다.
void	setMargin (Insets m) 툴바의 보더와 그 버튼의 사이의 마진을 설정합니다.
void	setOrientation (int o) 툴바의 방향을 설정합니다.
void	setRollover (boolean rollover) 이 툴바의 롤 오버 상태를 설정합니다.
void	setUI (ToolBarUI ui) 이 컴퍼넌트를 표현 하는 L&F 오브젝트를 설정합니다.
void	updateUI () L&F 가 변경된 것을 나타내는 UIFactory 로부터의 통지입니다.

클래스 javax.swing. JComponent 에서 상속받은 메소드

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

클래스 java.awt. Container 에서 상속받은 메소드

add , add , add , add , add , addContainerListener , applyComponentOrientation , areFocusTraversalKeysSet , countComponents , deliverEvent , doLayout , findComponentAt , findComponentAt , getComponent , getComponentAt , getComponentAt , getComponentCount , getComponents , getContainerListeners , getFocusTraversalKeys , getFocusTraversalPolicy , getLayout , insets , invalidate , isAncestorOf , isFocusCycleRoot , isFocusCycleRoot , isFocusTraversalPolicySet , layout , list , list , locate , minimumSize , paintComponents , preferredSize , printComponents , processContainerEvent , processEvent , remove , remove , removeAll , removeContainerListener , setFocusCycleRoot , setFocusTraversalKeys , setFocusTraversalPolicy , 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 , getBackground , getBounds , getColorModel , getComponentListeners , getComponentOrientation , getCursor , getDropTarget , getFocusCycleRootAncestor , getFocusListeners , getFocusTraversalKeysEnabled , getFont , getFontMetrics , getForeground , getGraphicsConfiguration , getHierarchyBoundsListeners , getHierarchyListeners , getIgnoreRepaint , getInputContext , getInputMethodListeners , getInputMethodRequests , getKeyListeners , getLocale , getLocation , getLocationOnScreen , getMouseListeners , getMouseMotionListeners , getMouseWheelListeners , getName , getParent , getPeer , getSize , getToolkit , getTreeLock , gotFocus , handleEvent , hasFocus , hide , imageUpdate , inside , isBackgroundSet , isCursorSet , isDisplayable , isEnabled , isFocusable , isFocusOwner , isFocusTraversable , isFontSet , isForegroundSet , isLightweight , 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 , processMouseEvent , processMouseWheelEvent , remove , removeComponentListener , removeFocusListener , removeHierarchyBoundsListener , removeHierarchyListener , removeInputMethodListener , removeKeyListener , removeMouseListener , removeMouseMotionListener , removeMouseWheelListener , 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

생성자의 상세

JToolBar

public JToolBar()

새로운 툴바를 작성합니다. 디폴트의 방향은 HORIZONTAL 입니다.

JToolBar

public JToolBar(int orientation)

orientation 를 지정해 새로운 툴바를 작성합니다. orientation 는 HORIZONTAL 또는 VERTICAL 의 어느 쪽인지 나오지 않으면 안됩니다.

파라미터:

orientation - 지정될 방향

JToolBar

public JToolBar(String  name)

name 를 지정해 신규의 툴바를 작성합니다. 이름은 떼어내진 툴바의 타이틀로서 사용합니다. 디폴트의 방향은 HORIZONTAL 입니다.

파라미터:

name - 툴바의 이름

도입된 버젼:

1.3

JToolBar

public JToolBar(String  name,
                int orientation)

지정된 name 와 orientation 로 새로운 툴바를 작성합니다. 다른 constructor 은 모두, 이 constructor를 호출합니다. orientation 가 무효인 값의 경우, 예외가 슬로우 됩니다.

파라미터:

name - 툴바의 이름

orientation - 초기 상태의 방향. HORIZONTAL 또는 VERTICAL

예외:

IllegalArgumentException - 방향이 HORIZONTAL,VERTICAL 가 어느 쪽도 아닌 경우

도입된 버젼:

1.3

메소드의 상세

getUI

public ToolBarUI  getUI()

툴바의 현재의 UI 를 돌려줍니다.

관련 항목:

setUI(javax.swing.plaf.ToolBarUI)

setUI

public void setUI(ToolBarUI  ui)

이 컴퍼넌트를 표현 하는 L&F 오브젝트를 설정합니다.

파라미터:

ui - ToolBarUI 의 L&F 오브젝트

관련 항목:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

L&F 가 변경된 것을 나타내는 UIFactory 로부터의 통지입니다. UI 를 UIFactory 로부터의 최신 버젼에 옮겨놓기 위해서(때문에) 불려 갑니다.

오버라이드(override):

클래스 JComponent 내의 updateUI

관련 항목:

JComponent.updateUI()

getUIClassID

public String  getUIClassID()

이 컴퍼넌트를 표현 하는 L&F 클래스의 이름을 돌려줍니다.

오버라이드(override):

클래스 JComponent 내의 getUIClassID

반환값:

캐릭터 라인 「ToolBarUI」

관련 항목:

JComponent.getUIClassID() , UIDefaults.getUI(javax.swing.JComponent)

getComponentIndex

public int getComponentIndex(Component  c)

지정된 컴퍼넌트의 인덱스를 돌려줍니다. separator도 1 개의 인덱스 위치를 점유 합니다.

파라미터:

c - 검색 대상의 Component

반환값:

컴퍼넌트의 위치를 나타내는 정수형. 0 은 선두 위치

getComponentAtIndex

public Component  getComponentAtIndex(int i)

지정된 인덱스의 컴퍼넌트를 돌려줍니다.

파라미터:

i - 컴퍼넌트의 위치. 0 은 선두 위치

반환값:

지정된 위치의 Component. 인덱스가 무효의 경우는 null

setMargin

public void setMargin(Insets  m)

툴바의 보더와 그 버튼의 사이의 마진을 설정합니다. null 로 설정하면(자), 툴바는 디폴트 마진을 사용합니다. 툴바의 디폴트 Border 오브젝트는 이 값을 사용해 적절한 마진을 작성합니다. 다만, 디폴트가 아닌 보더를 툴바로 설정하면(자),Border 오브젝트가 적절한 마진 스페이스를 작성합니다 (그 이외의 경우, 이 프로퍼티는 사실상 무시된다).

파라미터:

m - 보더와 버튼의 간격을 정의하는 Insets 오브젝트

관련 항목:

Insets

getMargin

public Insets  getMargin()

툴바의 보더와 그 버튼의 사이의 마진을 돌려줍니다.

반환값:

마진치를 보관 유지하는 Insets 오브젝트

관련 항목:

Insets

isBorderPainted

public boolean isBorderPainted()

borderPainted 프로퍼티를 돌려줍니다.

반환값:

borderPainted 프로퍼티의 값

관련 항목:

setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

borderPainted 프로퍼티를 설정합니다. 보더를 paint 하는 경우는 이 프로퍼티를 true 로 합니다. 이 프로퍼티의 기정치는 true 입니다. 일부의 Look & Feel 에서는 보더의 paint가 구현되어 있지 않을 가능성이 있습니다. 구현되어 있지 않은 경우, 이 프로퍼티는 무시됩니다.

파라미터:

b - true 의 경우는 보더가 paint 되는

관련 항목:

isBorderPainted()

paintBorder

protected void paintBorder(Graphics  g)

BorderPainted 프로퍼티가 true 의 경우, pop-up menu의 보더를 paint 합니다.

오버라이드(override):

클래스 JComponent 내의 paintBorder

파라미터:

g - paint를 하는 Graphics 문맥

관련 항목:

JComponent.paint(java.awt.Graphics) , JComponent.setBorder(javax.swing.border.Border)

isFloatable

public boolean isFloatable()

floatable 프로퍼티를 돌려줍니다.

반환값:

floatable 프로퍼티의 값

관련 항목:

setFloatable(boolean)

setFloatable

public void setFloatable(boolean b)

floatable 프로퍼티를 설정합니다. 유저가 툴바를 이동할 수 있게 하려면 , 이 프로퍼티를 true 로 할 필요가 있습니다. 통상의 경우, floatable, 즉 이동 가능한 툴바는 같은 컨테이너내의 다른 장소에 드러그 하거나 툴바 전용의 윈도우안에 드러그 아웃 하거나 할 수가 있습니다. 이 프로퍼티의 기정치는 true 입니다. 일부의 Look & Feel 에서는 이동식 툴바가 구현되어 있지 않을 가능성이 있습니다. 구현되어 있지 않은 경우, 이 프로퍼티는 무시됩니다.

파라미터:

b - 이동 가능한 툴바로 하는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

isFloatable()

getOrientation

public int getOrientation()

현재의 툴바의 방향을 돌려줍니다. 값은 HORIZONTAL 또는 VERTICAL 입니다.

반환값:

현재의 방향을 나타내는 정수치 (HORIZONTAL 또는 VERTICAL)

관련 항목:

setOrientation(int)

setOrientation

public void setOrientation(int o)

툴바의 방향을 설정합니다. 방향의 값은 HORIZONTAL 또는 VERTICAL 입니다. orientation 가 무효인 값의 경우, 예외가 슬로우 됩니다.

파라미터:

o - 신규의 방향. HORIZONTAL 또는 VERTICAL

예외:

IllegalArgumentException - 방향이 HORIZONTAL,VERTICAL 가 어느 쪽도 아닌 경우

관련 항목:

getOrientation()

setRollover

public void setRollover(boolean rollover)

이 툴바의 롤 오버 상태를 설정합니다. 롤 오버 상태가 true 의 경우, 마우스 포인터를 툴바 버튼의 위치로 이동했을 때만 버튼이 표현 됩니다. 이 프로퍼티의 기정치는 false 입니다.

Look & Feel 의 구현에 따라서는 이 프로퍼티가 무시되는 일도 있습니다.

파라미터:

rollover - 툴바 버튼의 롤 오버를 실시하는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.4

isRollover

public boolean isRollover()

롤 오버 상태를 돌려줍니다.

반환값:

롤 오버 툴바 버튼이 표현 되는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.4

관련 항목:

setRollover(boolean)

addSeparator

public void addSeparator()

디폴트 사이즈의 separator를 툴바의 종단에 추가합니다. 디폴트 사이즈는 현재의 Look & Feel 로 지정되고 있습니다.

addSeparator

public void addSeparator(Dimension  size)

지정된 사이즈의 separator를 툴바의 종단에 추가합니다.

파라미터:

size - separator의 Dimension

add

public JButton  add(Action  a)

액션을 디스팟치 하는 새로운 JButton 를 추가합니다.

JDK 1.3 이후는 이것은 컨테이너에 Action 를 추가하는 메소드로서는 추천하지 않습니다. 대신에,setAction 를 사용해 액션을 가지는 컨트롤을 설정해, 그 컨트롤을 직접 Container 에 추가하는 것을 추천합니다.

파라미터:

a - 새로운 메뉴 항목으로서 추가하는 Action 오브젝트

반환값:

액션을 디스팟치 하는 새로운 버튼

createActionComponent

protected JButton  createActionComponent(Action  a)

JToolBar 에 추가된 Action 의 JButton 를 작성하는 팩토리 메소드입니다. null 액션이 건네받았을 경우, 디폴트명은 비웁니다.

JDK 1.3 이후는 이것은 Container 에 Action 를 추가하는 메소드로서는 추천하지 않습니다. 대신에,setAction 를 사용해 액션을 가지는 컨트롤을 설정해, 그 컨트롤을 직접 Container 에 추가하는 것을 추천합니다.

파라미터:

a - 추가되는 버튼의 Action

반환값:

새롭게 작성된 버튼

관련 항목:

Action

createActionChangeListener

protected PropertyChangeListener  createActionChangeListener(JButton  b)

Action 에의 변경이 발생하는 경우에 컨트롤을 갱신하기 위한 , 적절히 설정된 PropertyChangeListener 를 돌려줍니다. 컨트롤에 디폴트의 프로퍼티 변경 청취자가 필요한 경우는 null 가 돌려주어집니다.

JDK 1.3 이후는 이것은 Container 에 Action 를 추가하는 메소드로서는 추천하지 않습니다. 대신에,setAction 를 사용해 액션을 가지는 컨트롤을 설정해, 그 컨트롤을 직접 Container 에 추가하는 것을 추천합니다.

반환값:

null

addImpl

protected void addImpl(Component  comp,
                       Object  constraints,
                       int index)

JButton 가 추가되면(자), 초기 상태에서는 사용 불가로 설정됩니다.

오버라이드(override):

클래스 Container 내의 addImpl

파라미터:

comp - 확장되는 컴퍼넌트

constraints - 컴퍼넌트로 준수되어야 할 제약

index - 컴퍼넌트의 인덱스

관련 항목:

Container.add(Component) , Container.add(Component, int) , Container.add(Component, java.lang.Object) , LayoutManager , LayoutManager2

paramString

protected String  paramString()

이 JToolBar 의 캐릭터 라인 표현을 돌려줍니다. 이 메소드는 디버그 전용이며, 돌려주어지는 캐릭터 라인의 컨텐츠 및 형식은 구현에 따라서 다릅니다. 돌려주어지는 캐릭터 라인은 비었을 경우가 있습니다만,null 로는 되지 않습니다.

오버라이드(override):

클래스 JComponent 내의 paramString

반환값:

이 JToolBar 의 캐릭터 라인 표현

setLayout

public void setLayout(LayoutManager  mgr)

클래스 Container 의 기술:

이 컨테이너의 레이아웃 매니저를 설정합니다.

오버라이드(override):

클래스 Container 내의 setLayout

파라미터:

mgr - 지정된 레이아웃 매니저

관련 항목:

Container.doLayout() , Container.getLayout()

getAccessibleContext

public AccessibleContext  getAccessibleContext()

이 JToolBar 에 관련한 AccessibleContext 를 돌려줍니다. 툴바의 경우, AccessibleContext 는 AccessibleJToolBar 의 형식을 취합니다. 필요에 따라서 신규의 AccessibleJToolBar 인스턴스가 작성됩니다.

정의:

인터페이스 Accessible 내의 getAccessibleContext

오버라이드(override):

클래스 JComponent 내의 getAccessibleContext

반환값:

이 JToolBar 의 AccessibleContext 로서 기능하는 AccessibleJToolBar