JavaTM 2 Platform
Standard Ed. 5.0

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 を実行するアプリケーション間の RMI に適しています。JDK バージョン 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.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, 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, 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

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)

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