javax.swing
クラス JToolBar

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

public class JToolBar

extends JComponent

implements SwingConstants, Accessible

JToolBar は、一般的に使用される Action やコントロールを表示するのに役立つコンポーネントを提供します。ユーザはこれを (浮動可能プロパティが false に設定されていないかぎり) ドラッグアウトして独立したウィンドウに入れることができます。ドラッグアウトを適切に機能させるには、レイアウトマネージャが BorderLayout であるコンテナの 4 辺の 1 つに JToolBar のインスタンスを追加し、それ以外の辺には子を追加しないことをお勧めします。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、JToolBar のキーの割り当てを参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:

Action, 直列化された形式

内部クラスの概要

protected class	JToolBar.AccessibleJToolBar このオブジェクトのユーザ補助機能を取得するために使用するクラスです。
static class	JToolBar.Separator ツールバー独自のセパレータです。

クラス javax.swing.JComponent から継承した内部クラス

JComponent.AccessibleJComponent

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

コンストラクタの概要

JToolBar()
新しいツールバーを作成します。

JToolBar(int orientation)
新しいツールバーを作成します。

メソッドの概要

JButton	add(Action a) アクションをディスパッチする新しい JButton を追加します。
protected void	addImpl(Component comp, Object constraints, int index)
void	addSeparator() デフォルトサイズのツールバーのセパレータをツールバーの終端に追加します。
void	addSeparator(Dimension size) ツールバーのセパレータをツールバーの終端に追加します。
protected PropertyChangeListener	createActionChangeListener(JButton b)
AccessibleContext	getAccessibleContext() この JComponent に関連付けられている AccessibleContext を取得します。
Component	getComponentAtIndex(int i) 指定されたインデックスのコンポーネントを返します。
int	getComponentIndex(Component c) 指定されたコンポーネントのインデックスを返します。
Insets	getMargin() ツールバーのボーダとそのボタンの間のマージンを返します。
int	getOrientation() ツールバーの現在の方向を返します。
ToolBarUI	getUI() ツールバーの現在の UI を返します。
String	getUIClassID() コンポーネントを描画する L&F クラスの名前を返します。
boolean	isBorderPainted() ボーダをペイントするかどうかを調べます。
boolean	isFloatable() ユーザが Toolbar をドラッグアウトできる場合に true を返します。
protected void	paintBorder(Graphics g) BorderPainted プロパティが true の場合に、ツールバーのボーダをペイントします。
protected String	paramString() この JToolBar の文字列表現を返します。
void	remove(Component comp) ツールバーから Component を削除します。
void	setBorderPainted(boolean b) ボーダをペイントするかどうかを設定します。
void	setFloatable(boolean b) ツールバーを浮動状態にできるかどうかを設定します。
void	setMargin(Insets m) ツールバーのボーダとそのボタンの間のマージンを設定します。
void	setOrientation(int o) ツールバーの方向を設定します。
void	setUI(ToolBarUI ui) このコンポーネントを描画する L&F オブジェクトを設定します。
void	updateUI() L&F が変更されたことを示す UIFactory からの通知です。

クラス javax.swing.JComponent から継承したメソッド

addAncestorListener, addNotify, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInsets, getInsets, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, processComponentKeyEvent, processFocusEvent, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

add, add, add, add, add, addContainerListener, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, setLayout, validate, validateTree

クラス java.awt.Component から継承したメソッド

action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hide, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus

クラス java.lang.Object から継承したメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

JToolBar

public JToolBar()

新しいツールバーを作成します。方向のデフォルトは水平です。

JToolBar

public JToolBar(int orientation)

新しいツールバーを作成します。

パラメータ:

orientation - 初期状態の方向 (HORIZONTAL または VERTICAL)

メソッドの詳細

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 クラスの名前を返します。

戻り値:

"ToolBarUI"

オーバーライド:

クラス JComponent 内の getUIClassID

関連項目:

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

getComponentIndex

public int getComponentIndex(Component c)

指定されたコンポーネントのインデックスを返します。注: セパレータは 1 つのインデックス位置を占有します。

パラメータ:

c - 検索対象の Component

戻り値:

コンポーネントの位置を示す int 値。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()

ボーダをペイントするかどうかを調べます。

戻り値:

ボーダをペイントする場合は true、そうでない場合は false

関連項目:

setBorderPainted

setBorderPainted

public void setBorderPainted(boolean b)

ボーダをペイントするかどうかを設定します。

パラメータ:

b - true の場合はボーダがペイントされる

関連項目:

isBorderPainted

paintBorder

protected void paintBorder(Graphics g)

BorderPainted プロパティが true の場合に、ツールバーのボーダをペイントします。

パラメータ:

g - ペイントが行われるグラフィックスコンテキスト

オーバーライド:

クラス JComponent 内の paintBorder

関連項目:

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

isFloatable

public boolean isFloatable()

ユーザが Toolbar をドラッグアウトできる場合に true を返します。

戻り値:

ユーザが Toolbar をドラッグアウトできる場合は true

setFloatable

public void setFloatable(boolean b)

ツールバーを浮動状態にできるかどうかを設定します。

パラメータ:

b - true の場合は、ツールバーをドラッグアウトできる

関連項目:

isFloatable

getOrientation

public int getOrientation()

ツールバーの現在の方向を返します。

戻り値:

現在の方向を表す int 値 (HORIZONTAL/VERTICAL)

関連項目:

setOrientation

setOrientation

public void setOrientation(int o)

ツールバーの方向を設定します。

パラメータ:

o - 新しい方向 (HORIZONTAL/VERTICAL)

関連項目:

getOrientation

addSeparator

public void addSeparator()

デフォルトサイズのツールバーのセパレータをツールバーの終端に追加します。

addSeparator

public void addSeparator(Dimension size)

ツールバーのセパレータをツールバーの終端に追加します。

パラメータ:

size - セパレータのサイズ

add

public JButton add(Action a)

アクションをディスパッチする新しい JButton を追加します。

パラメータ:

a - 新しいメニュー項目として追加する Action オブジェクト

remove

public void remove(Component comp)

ツールバーから Component を削除します。

パラメータ:

comp - 削除対象のコンポーネント

オーバーライド:

クラス Container 内の remove

addImpl

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

オーバーライド:

クラス Container 内の addImpl

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JButton b)

paramString

protected String paramString()

この JToolBar の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null にはなりません。

JFC コンポーネントの新しい側面についての情報を返すには、paramString() をオーバーライドします。

戻り値:

この JToolBar の文字列表現

オーバーライド:

クラス JComponent 内の paramString

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JComponent に関連付けられている AccessibleContext を取得します。

定義:

インタフェース Accessible 内の getAccessibleContext

戻り値:

この JComponent の AccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext