javax.swing
클래스 JToolBar

java.lang.Object 
  java.awt.Component 
      java.awt.Container 
          javax.swing.JComponent 
              javax.swing.JToolBar

모든 구현된 인터페이스:

ImageObserver, MenuContainer, Serializable, Accessible, 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 인스턴스를 추가해, 그 이외의 옆에는 자식을 추가하지 않는 것을 추천합니다.

경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 1.4 이후, 모든 JavaBeans^™ 장기간의 운용 지원은 java.beans 패키지에 추가되고 있습니다. 자세한 내용은 XMLEncoder를 참조하십시오.

관련 항목:

Action

중첩(Nested) 클래스 개요

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

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, 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의 보더를 페인트 합니다.
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, 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, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, 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

클래스 java.awt. Container 로부터 상속된 메서드

add, add, add, add, add, addContainerListener, 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

생성자 상세

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로 새로운 툴바를 작성합니다. 다른 생성자는 모두, 이 생성자를 호출합니다. 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 프로퍼티를 설정합니다. 보더를 페인트 하는 경우는 이 프로퍼티를 true로 합니다. 이 프로퍼티의 기정치는 true 입니다. 일부의 Look & Feel 에서는 보더의 페인트가 구현되어 있지 않을 가능성이 있습니다. 구현되어 있지 않은 경우, 이 프로퍼티는 무시됩니다.

파라미터:

b - true인 경우는 보더가 페인트 되는

관련 항목:

isBorderPainted()

paintBorder

protected void paintBorder(Graphics  g)

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

오버라이드(override):

클래스 JComponent 내의 paintBorder

파라미터:

g - 페인트를 하는 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