JavaTM 2 Platform
Standard Ed. 5.0

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)
          指定された nameorientation で新しいツールバーを作成します。
 
メソッドの概要
 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 に追加された ActionJButton を作成するファクトリメソッドです。
 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)
指定された nameorientation で新しいツールバーを作成します。他のコンストラクタはすべて、このコンストラクタを呼び出します。orientation が無効な値の場合、例外がスローされます。

パラメータ:
name - ツールバーの名前
orientation - 初期状態の方向。HORIZONTAL または VERTICAL
例外:
IllegalArgumentException - 方向が HORIZONTALVERTICAL のどちらでもない場合
導入されたバージョン:
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 - 方向が HORIZONTALVERTICAL のどちらでもない場合
関連項目:
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 に追加された ActionJButton を作成するファクトリメソッドです。null アクションが渡された場合、デフォルト名は空になります。

JDK 1.3 以降は、これは ContainerAction を追加するメソッドとしてはお勧めしません。代わりに、setAction を使用してアクションを持つコントロールを設定し、そのコントロールを直接 Container に追加することをお勧めします。

パラメータ:
a - 追加されるボタンの Action
戻り値:
新しく作成されたボタン
関連項目:
Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JButton b)
Action への変更が発生する場合にコントロールを更新するための、適切に設定された PropertyChangeListener を返します。コントロールにデフォルトのプロパティ変更リスナーが必要な場合は、null が返されます。

JDK 1.3 以降は、これは ContainerAction を追加するメソッドとしてはお勧めしません。代わりに、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

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 も参照してください。