JMenuBar (Java Platform SE 8 )

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

All Implemented Interfaces:

ImageObserver ， MenuContainer ， Serializable ， Accessible ， MenuElement

已知直接子类：

BasicInternalFrameTitlePane.SystemMenuBar
```
public class JMenuBar
extends JComponent
implements Accessible, MenuElement
```
一个菜单栏的实现。您将JMenu对象添加到菜单栏中以构建菜单。当用户选择一个JMenu对象，其相关联的JPopupMenu被显示，从而允许用户选择所述的一个JMenuItems就可以了。
有关使用菜单栏的信息和示例，请参阅Java教程中的 How to Use Menus 。

警告： Swing不是线程安全的。有关更多信息，请参阅Swing's Threading Policy 。

警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，对所有JavaBeans的长期存储的支持已被添加到java.beans包中。请参阅XMLEncoder 。

警告：默认情况下，按下Tab键不会从转移焦点JMenuBar被添加到与其他Swing组件的容器一起，因为focusTraversalKeysEnabled财产JMenuBar设置为false 。要解决这个问题，你应该调用JMenuBar.setFocusTraversalKeysEnabled(true)方法。

另请参见：

JMenu ， JPopupMenu ， JMenuItem

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`JMenuBar.AccessibleJMenuBar` 这个类实现了可访问性支持 `JMenuBar`类。

Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary
- Fields inherited from class javax.swing.JComponent
  listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
- Fields inherited from class java.awt.Component
  accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
- Fields inherited from interface java.awt.image.ImageObserver
  ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

构造方法摘要

构造方法
Constructor and Description
`JMenuBar()` 创建一个新的菜单栏。

方法摘要

所有方法接口方法具体的方法弃用的方法
Modifier and Type	Method and Description
`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`属性为真，则 `BorderPainted`菜单栏的边框。
`protected String`	`paramString()` 返回此 `JMenuBar`的字符串表示 `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)` 设置用户在菜单栏中选择“帮助”选项时出现的帮助菜单。
`void`	`setMargin(Insets m)` 设置菜单边界和菜单之间的边距。
`void`	`setSelected(Component sel)` 设置当前选择的组件，产生对选择模型的更改。
`void`	`setSelectionModel(SingleSelectionModel model)` 设置模型对象以处理单个选择。
`void`	`setUI(MenuBarUI ui)` 设置渲染此组件的L＆F对象。
`void`	`updateUI()` 将UI属性重新设置为来自当前外观的值。

Methods inherited from class 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, 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

Methods inherited from class 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

Methods inherited from class 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, 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, transferFocusBackward, transferFocusUpCycle

Methods inherited from class 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()
```
    将UI属性重新设置为来自当前外观的值。
    
    重写：
    
    updateUI在 JComponent
    
    另请参见：
    
    JComponent.updateUI()
  - getUIClassID
```
public String getUIClassID()
```
    返回呈现此组件的L＆F类的名称。
    
    重写：
    
    getUIClassID在 JComponent
    
    结果
    
    字符串“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 ，或 null如果在该位置没有 JMenu （即如果是 JMenuItem ）
  - getMenuCount
```
public int getMenuCount()
```
    返回菜单栏中的项目数。
    
    结果
    
    菜单栏中的项目数
  - setHelpMenu
```
public void setHelpMenu(JMenu menu)
```
    设置用户在菜单栏中选择“帮助”选项时出现的帮助菜单。此方法尚未实现，并将抛出异常。
    
    参数
    
    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。
    
    结果
    
    如果边框应该涂漆，否则为假
  - setBorderPainted
```
public void setBorderPainted(boolean b)
```
    设置是否应绘制边框。
    
    参数
    
    b - 如果true和border属性不是 null ，则绘制边框。
    
    另请参见：
    
    isBorderPainted()
  - paintBorder
```
protected void paintBorder(Graphics g)
```
    如果 BorderPainted属性为true，则 BorderPainted菜单栏的边框。
    
    重写：
    
    paintBorder在 JComponent
    
    参数
    
    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对象
    
    另请参见：
    
    Insets
  - processMouseEvent
```
public void processMouseEvent(MouseEvent event,
                              MenuElement[] path,
                              MenuSelectionManager manager)
```
    实现成为一个 MenuElement - 什么也没做。
    
    Specified by:
    
    processMouseEvent在接口 MenuElement
    
    另请参见：
    
    getSubElements()
  - processKeyEvent
```
public void processKeyEvent(KeyEvent e,
                            MenuElement[] path,
                            MenuSelectionManager manager)
```
    实现为 MenuElement - 什么也没做。
    
    Specified by:
    
    processKeyEvent在接口 MenuElement
    
    另请参见：
    
    getSubElements()
  - menuSelectionChanged
```
public void menuSelectionChanged(boolean isIncluded)
```
    实现成为一个 MenuElement - 什么也没做。
    
    Specified by:
    
    menuSelectionChanged在接口 MenuElement
    
    另请参见：
    
    getSubElements()
  - getSubElements
```
public MenuElement[] getSubElements()
```
    实现为MenuElement - 返回此菜单栏中的菜单。这是用于实现的原因MenuElement接口-使得菜单栏可被处理同其他菜单元素。
    
    Specified by:
    
    getSubElements在接口 MenuElement
    
    结果
    
    菜单栏中的一系列菜单项。
  - getComponent
```
public Component getComponent()
```
    实现为MenuElement 。返回此对象。
    
    Specified by:
    
    getComponent在界面 MenuElement
    
    结果
    
    当前 Component （这）
    
    另请参见：
    
    getSubElements()
  - paramString
```
protected String paramString()
```
    返回此JMenuBar的字符串表示JMenuBar 。该方法仅用于调试目的，并且返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是null 。
    
    重写：
    
    paramString在 JComponent
    
    结果
    
    这个 JMenuBar的字符串表示 JMenuBar
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此JMenuBar关联的AccessibleContext。对于JMenuBars，AccessibleContext采用AccessibleJMenuBar的形式。如有必要，将创建一个新的AccessibleJMenuBar实例。
    
    Specified by:
    
    getAccessibleContext在界面 Accessible
    
    重写：
    
    getAccessibleContext在 Component
    
    结果
    
    一个AccessibleJMenuBar，作为这个JMenuBar的AccessibleContext
  - 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)

Class JMenuBar

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

Nested classes/interfaces inherited from class java.awt.Container

Nested classes/interfaces inherited from class java.awt.Component

Field Summary

Fields inherited from class javax.swing.JComponent

Fields inherited from class java.awt.Component

Fields inherited from interface java.awt.image.ImageObserver

构造方法摘要

方法摘要

Methods inherited from class javax.swing.JComponent

Methods inherited from class java.awt.Container

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

构造方法详细信息

JMenuBar

方法详细信息

getUI

setUI

updateUI

getUIClassID

getSelectionModel

setSelectionModel

add

getMenu

getMenuCount

setHelpMenu

getHelpMenu

getComponentAtIndex

getComponentIndex

setSelected

isSelected

isBorderPainted

setBorderPainted

paintBorder

setMargin

getMargin

processMouseEvent

processKeyEvent

menuSelectionChanged

getSubElements

getComponent

paramString

getAccessibleContext

processKeyBinding

addNotify

removeNotify