モジュール java.desktop

パッケージ 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

@JavaBean(defaultProperty="UI", description="A container for holding and displaying menus.") public class JMenuBar extends JComponent implements Accessible, MenuElement

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

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

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

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

警告: デフォルトでは、JMenuBarのfocusTraversalKeysEnabledプロパティはfalseに設定されているため、[Tab]キーを押しても、他のSwingコンポーネントとともにコンテナに追加されたJMenuBarからフォーカスは移動しません。 これを解決するには、JMenuBar.setFocusTraversalKeysEnabled(true)メソッドを呼び出す必要があります。

導入されたバージョン:

1.2

関連項目:

• 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で宣言されたフィールド

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

クラスjava.awt.Componentで宣言されたフィールド

accessibleContext, 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.removeNotifyをオーバーライドします。
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()	現在のルック・アンド・フィールからの値を持つUIプロパティをリセットします。

クラスjavax.swing.JComponentで宣言されたメソッド

addAncestorListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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, 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, 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, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

クラスjava.lang.Objectで宣言されたメソッド

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

コンストラクタの詳細

JMenuBar

public JMenuBar()

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

メソッドの詳細

getUI

public MenuBarUI getUI()

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

オーバーライド:

クラスJComponentのgetUI

戻り値:

メニュー・バーの現在のL&FオブジェクトであるMenuBarUI

関連項目:

• setUI(javax.swing.plaf.MenuBarUI)

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(MenuBarUI ui)

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

パラメータ:

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

関連項目:

• UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在のルック・アンド・フィールからの値を持つUIプロパティをリセットします。

オーバーライド:

updateUI、クラスJComponent

関連項目:

• JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

このコンポーネントをレンダリングするL&Fクラスの名前を返します。

オーバーライド:

getUIClassID、クラスJComponent

戻り値:

文字列「MenuBarUI」

関連項目:

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

getSelectionModel

public SingleSelectionModel getSelectionModel()

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

戻り値:

SingleSelectionModelプロパティ

関連項目:

• SingleSelectionModel

setSelectionModel

@BeanProperty(description="The selection model, recording which child is selected.") 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

@BeanProperty(bound=false) 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

@BeanProperty(bound=false) public boolean isSelected()

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

戻り値:

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

isBorderPainted

public boolean isBorderPainted()

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

戻り値:

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

setBorderPainted

@BeanProperty(visualUpdate=true, description="Whether the border should be painted.") public void setBorderPainted(boolean b)

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

パラメータ:

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

関連項目:

• isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)

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

オーバーライド:

paintBorder、クラスJComponent

パラメータ:

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

関連項目:

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

setMargin

@BeanProperty(visualUpdate=true, description="The space between the menubar\'s border and its contents") 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として実装されますが、処理は行いません。

定義:

processMouseEvent、インタフェースMenuElement

パラメータ:

event - 処理されるMouseEvent

path - メニュー階層内の受信要素のパス

manager - メニュー階層のMenuSelectionManager

関連項目:

• getSubElements()

processKeyEvent

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

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

定義:

processKeyEvent、インタフェースMenuElement

パラメータ:

e - 処理されるKeyEvent

path - メニュー階層内の受信要素のパス

manager - メニュー階層のMenuSelectionManager

関連項目:

• getSubElements()

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

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

定義:

menuSelectionChanged、インタフェースMenuElement

パラメータ:

isIncluded - このMenuElementがアクティブな(メニューの場合)か、(メニュー項目の場合)を変更したメニュー・パスの部分にあるかどうかを示すために使用できます。

関連項目:

• getSubElements()

getSubElements

@BeanProperty(bound=false) public MenuElement[] getSubElements()

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

定義:

getSubElements、インタフェースMenuElement

戻り値:

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

getComponent

public Component getComponent()

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

定義:

getComponent、インタフェースMenuElement

戻り値:

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

関連項目:

• getSubElements()

paramString

protected String paramString()

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

オーバーライド:

paramString、クラスJComponent

戻り値:

このJMenuBarの文字列表現

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

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

定義:

getAccessibleContext、インタフェースAccessible

オーバーライド:

getAccessibleContext、クラスComponent

戻り値:

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

processKeyBinding

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

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

オーバーライド:

processKeyBinding、クラスJComponent

パラメータ:

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をオーバーライドします。

オーバーライド:

addNotify、クラスJComponent

関連項目:

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

removeNotify

public void removeNotify()

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

オーバーライド:

removeNotify、クラスJComponent

関連項目:

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