javax.swing
クラス JMenuBar

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

すべての実装されたインタフェース:

ImageObserver, MenuContainer, Serializable, Accessible, MenuElement

直系の既知のサブクラス:

BasicInternalFrameTitlePane.SystemMenuBar

public class JMenuBar
extends JComponent
implements Accessible, MenuElement

メニューバーの実装です。メニューを構築するには、メニューバーに JMenu オブジェクトを追加します。ユーザーが JMenu オブジェクトを選択すると、対応する JPopupMenu が表示され、ユーザーは JMenuItem のいずれかを選択することができます。

メニューバーの使用方法の詳細と例については、「The Java Tutorial」の「How to Use Menus」を参照してください。

警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK Version 1.4 以降、すべての JavaBeans^™ の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

関連項目:

JMenu, JPopupMenu, JMenuItem

入れ子のクラスの概要

protected class

JMenuBar.AccessibleJMenuBar このクラスは JMenuBar クラス用のアクセシビリティーサポートを実装しています。

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, 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

インタフェース java.awt.image.ImageObserver から継承されたフィールド

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

コンストラクタの概要

JMenuBar()
新しいメニューバーを作成します。

メソッドの概要

JMenu	add(JMenu c) メニューバーの最後に、指定されたメニューを追加します。
void	addNotify() このメニューバーを現在のキーボードマネージャーに登録するために、JComponent.addNotify をオーバーライドします。
AccessibleContext	getAccessibleContext() この JMenuBar に関連した AccessibleContext を返します。
Component	getComponent() MenuElement として実装されます。
Component	getComponentAtIndex(int i) 推奨されていません。 getComponent(int i) に置き換えられました。
int	getComponentIndex(Component c) 指定されたコンポーネントのインデックスを返します。
JMenu	getHelpMenu() メニューバーのヘルプメニューを取得します。
Insets	getMargin() メニューバーのボーダーとそのメニューの間のマージンを返します。
JMenu	getMenu(int index) メニューバーの指定された位置のメニューを返します。
int	getMenuCount() メニューバーの項目数を返します。
SingleSelectionModel	getSelectionModel() 単一の選択を扱うモデルオブジェクトを返します。
MenuElement[]	getSubElements() MenuElement として実装され、このメニューバーのメニューを返します。
MenuBarUI	getUI() メニューバーの現在の UI を返します。
String	getUIClassID() このコンポーネントを描画する L&F クラスの名前を返します。
boolean	isBorderPainted() メニューバーのボーダーをペイントする必要がある場合に true を返します。
boolean	isSelected() メニューバーのコンポーネントが現在選択されている場合に true を返します。
void	menuSelectionChanged(boolean isIncluded) MenuElement として実装されますが、処理は行いません。
protected void	paintBorder(Graphics g) BorderPainted プロパティーが true の場合、メニューバーのボーダーをペイントします。
protected String	paramString() この JMenuBar の文字列表現を返します。
protected boolean	processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed) すべての子メニューを確認するためにサブクラス化されます。
void	processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager) MenuElement として実装されますが、処理は行いません。
void	processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager) MenuElement として実装されますが、処理は行いません。
void	removeNotify() このメニューバーを現在のキーボードマネージャーから登録解除するために、JComponent.addNotify をオーバーライドします。
void	setBorderPainted(boolean b) ボーダーをペイントするかどうかを設定します。
void	setHelpMenu(JMenu menu) ユーザーがメニューバーで「ヘルプ (help)」オプションを選択すると表示されるヘルプメニューを設定します。
void	setMargin(Insets m) メニューバーのボーダーとそのメニューの間のマージンを設定します。
void	setSelected(Component sel) 現在選択されているコンポーネントを設定します。
void	setSelectionModel(SingleSelectionModel model) 単一の選択を扱うモデルオブジェクトを設定します。
void	setUI(MenuBarUI ui) このコンポーネントを描画する L&F オブジェクトを設定します。
void	updateUI() 現在の Look & Feel からの値を持つ UI プロパティーをリセットします。

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

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, 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, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, 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, addImpl, 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, setLayout, 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

コンストラクタの詳細

JMenuBar

public JMenuBar()

新しいメニューバーを作成します。

メソッドの詳細

getUI

public MenuBarUI getUI()

メニューバーの現在の UI を返します。

関連項目:

setUI(javax.swing.plaf.MenuBarUI)

setUI

public void setUI(MenuBarUI ui)

このコンポーネントを描画する L&F オブジェクトを設定します。

パラメータ:

ui - 新しい MenuBarUI L&F オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在の Look & Feel からの値を持つ UI プロパティーをリセットします。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

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

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

文字列「MenuBarUI」

関連項目:

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

getSelectionModel

public SingleSelectionModel getSelectionModel()

単一の選択を扱うモデルオブジェクトを返します。

戻り値:

SingleSelectionModel プロパティー

関連項目:

SingleSelectionModel

setSelectionModel

public void setSelectionModel(SingleSelectionModel model)

単一の選択を扱うモデルオブジェクトを設定します。

パラメータ:

model - 使用する SingleSelectionModel

関連項目:

SingleSelectionModel

add

public JMenu add(JMenu c)

メニューバーの最後に、指定されたメニューを追加します。

パラメータ:

c - 追加する JMenu コンポーネント

戻り値:

メニューコンポーネント

getMenu

public JMenu getMenu(int index)

メニューバーの指定された位置のメニューを返します。

パラメータ:

index - メニューバーの位置を示す整数。0 は先頭位置

戻り値:

指定された位置の JMenu。その位置に JMenu がない場合、たとえばそれが JMenuItem の場合は null

getMenuCount

public int getMenuCount()

メニューバーの項目数を返します。

戻り値:

メニューバーの項目数

setHelpMenu

public void setHelpMenu(JMenu menu)

ユーザーがメニューバーで「ヘルプ (help)」オプションを選択すると表示されるヘルプメニューを設定します。このメソッドはまだ実装されていないので、例外がスローされます。

パラメータ:

menu - ユーザーにヘルプを提示する JMenu

getHelpMenu

public JMenu getHelpMenu()

メニューバーのヘルプメニューを取得します。このメソッドはまだ実装されていないので、例外がスローされます。

戻り値:

ユーザーにヘルプを提示する JMenu

getComponentAtIndex

@Deprecated
public Component getComponentAtIndex(int i)

推奨されていません。 getComponent(int i) に置き換えられました。

指定されたインデックスの要素を返します。

パラメータ:

i - 位置を示す整数。0 は先頭

戻り値:

指定された位置の Component。 インデックスが無効の場合は null

getComponentIndex

public int getComponentIndex(Component c)

指定されたコンポーネントのインデックスを返します。

パラメータ:

c - 検索対象の Component

戻り値:

コンポーネントの位置を示す整数。 先頭の場合は 0、見つからなかった場合は -1

setSelected

public void setSelected(Component sel)

現在選択されているコンポーネントを設定します。選択モデルを変更します。

パラメータ:

sel - 選択する Component

isSelected

public boolean isSelected()

メニューバーのコンポーネントが現在選択されている場合に true を返します。

戻り値:

選択されている場合は true、そうでない場合は false

isBorderPainted

public boolean isBorderPainted()

メニューバーのボーダーをペイントする必要がある場合に true を返します。

戻り値:

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

setBorderPainted

public void setBorderPainted(boolean b)

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

パラメータ:

b - このパラメータが true で、ボーダーのプロパティーが null でない場合、ボーダーをペイントする

関連項目:

isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)

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

オーバーライド:

クラス JComponent 内の paintBorder

パラメータ:

g - ペイントに使用する Graphics コンテキスト

関連項目:

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

setMargin

public void setMargin(Insets m)

メニューバーのボーダーとそのメニューの間のマージンを設定します。null に設定すると、メニューバーのマージンにはデフォルトが使用されます。

パラメータ:

m - マージン値を保持する Insets オブジェクト

関連項目:

Insets

getMargin

public Insets getMargin()

メニューバーのボーダーとそのメニューの間のマージンを返します。設定されているマージンがない場合、サイズがゼロのデフォルトマージンを作成します。

戻り値:

マージン値を保持する Insets オブジェクト

関連項目:

Insets

processMouseEvent

public void processMouseEvent(MouseEvent event,
                              MenuElement[] path,
                              MenuSelectionManager manager)

MenuElement として実装されますが、処理は行いません。

定義:

インタフェース MenuElement 内の processMouseEvent

関連項目:

getSubElements()

processKeyEvent

public void processKeyEvent(KeyEvent e,
                            MenuElement[] path,
                            MenuSelectionManager manager)

MenuElement として実装されますが、処理は行いません。

定義:

インタフェース MenuElement 内の processKeyEvent

関連項目:

getSubElements()

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

MenuElement として実装されますが、処理は行いません。

定義:

インタフェース MenuElement 内の menuSelectionChanged

関連項目:

getSubElements()

getSubElements

public MenuElement[] getSubElements()

MenuElement として実装され、このメニューバーのメニューを返します。メニューバーをほかのメニュー要素と同じように扱えるようにするために、MenuElement インタフェースを実装します。

定義:

インタフェース MenuElement 内の getSubElements

戻り値:

メニューバーのメニュー項目の配列

getComponent

public Component getComponent()

MenuElement として実装されます。このオブジェクトを返します。

定義:

インタフェース MenuElement 内の getComponent

戻り値:

現在の Component (this オブジェクト)

関連項目:

getSubElements()

paramString

protected String paramString()

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

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JMenuBar の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

この JMenuBar の AccessibleContext として機能する AccessibleJMenuBar

processKeyBinding

protected boolean processKeyBinding(KeyStroke ks,
                                    KeyEvent e,
                                    int condition,
                                    boolean pressed)

すべての子メニューを確認するためにサブクラス化されます。

オーバーライド:

クラス JComponent 内の processKeyBinding

パラメータ:

ks - 照会する KeyStroke

e - KeyEvent

condition - 次の値のいずれか。

• JComponent.WHEN_FOCUSED
• JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT
• JComponent.WHEN_IN_FOCUSED_WINDOW

pressed - キーが押されている場合は true

戻り値:

アクションにバインディングがあり、アクションが有効だった場合は true

導入されたバージョン:

1.3

addNotify

public void addNotify()

このメニューバーを現在のキーボードマネージャーに登録するために、JComponent.addNotify をオーバーライドします。

オーバーライド:

クラス JComponent 内の addNotify

関連項目:

JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)

removeNotify

public void removeNotify()

このメニューバーを現在のキーボードマネージャーから登録解除するために、JComponent.addNotify をオーバーライドします。

オーバーライド:

クラス JComponent 内の removeNotify

関連項目:

JComponent.registerKeyboardAction(java.awt.event.ActionListener, java.lang.String, javax.swing.KeyStroke, int)