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

入れ子のクラスの概要

protected class	JToolBar.AccessibleJToolBar このクラスは JToolBar クラス用のユーザ補助機能のサポートを実装しています。
static class	JToolBar.Separator ツールバー独自のセパレータです。

クラス javax.swing.JComponent から継承された入れ子のクラス/インタフェース

JComponent.AccessibleJComponent

クラス java.awt.Container から継承された入れ子のクラス/インタフェース

Container.AccessibleAWTContainer

クラス java.awt.Component から継承された入れ子のクラス/インタフェース

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() デフォルトサイズのセパレータをツールバーの終端に追加します。
void	addSeparator(Dimension size) 指定されたサイズのセパレータをツールバーの終端に追加します。
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 の場合、ポップアップメニューのボーダをペイントします。
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 からの最新バージョンに置き換えるために呼び出されます。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

このコンポーネントを描画する L&F クラスの名前を返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

文字列「ToolBarUI」

関連項目:

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

getComponentIndex

public int getComponentIndex(Component c)

指定されたコンポーネントのインデックスを返します。セパレータも 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 の場合、ポップアップメニューのボーダをペイントします。

オーバーライド:

クラス 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()

デフォルトサイズのセパレータをツールバーの終端に追加します。デフォルトサイズは現在の Look & Feel で指定されています。

addSeparator

public void addSeparator(Dimension size)

指定されたサイズのセパレータをツールバーの終端に追加します。

パラメータ:

size - セパレータの 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 が追加されると、初期状態では使用不可に設定されます。

オーバーライド:

クラス 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 にはなりません。

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JToolBar の文字列表現

setLayout

public void setLayout(LayoutManager mgr)

クラス Container の記述:

このコンテナのレイアウトマネージャを設定します。

オーバーライド:

クラス Container 内の setLayout

パラメータ:

mgr - 指定されたレイアウトマネージャ

関連項目:

Container.doLayout(), Container.getLayout()

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JToolBar に関連した AccessibleContext を返します。ツールバーの場合、AccessibleContext は AccessibleJToolBar の形式を取ります。必要に応じて新規の AccessibleJToolBar インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

この JToolBar の AccessibleContext として機能する AccessibleJToolBar