javax.swing
Class JMenuBar

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JMenuBar
All Implemented Interfaces:
Accessible, ImageObserver, MenuContainer, MenuElement, Serializable
Direct Known Subclasses:
BasicInternalFrameTitlePane.SystemMenuBar
public class JMenuBar
extends JComponent
implements Accessible, MenuElement

An implementation of a menu bar. You add JMenu objects to the menu bar to construct a menu. When the user selects a JMenu object, its associated JPopupMenu is displayed, allowing the user to select one of the JMenuItems on it.

For information and examples of using menu bars see How to Use Menus, a section in The Java Tutorial. For the keyboard keys used by this component in the standard Look and Feel (L&F) renditions, see the JMenuBar key assignments.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the java.beans package. Please see XMLEncoder.

See Also:
JMenu, JPopupMenu, JMenuItem

 

Nested Class Summary

protected  class JMenuBar.AccessibleJMenuBar
    This class implements accessibility support for the JMenuBar class.
 
Nested classes inherited from class javax.swing.JComponent
 
Nested classes inherited from class java.awt.Container
 
Nested classes inherited from class java.awt.Component
Component.BltBufferStrategy, Component.FlipBufferStrategy
 

 

Field Summary

 
Fields inherited from class javax.swing.JComponent
accessibleContext, 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
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 Summary

JMenuBar()
    Creates a new menu bar.
 

 

Method Summary

 JMenu add(JMenu c)
    Appends the specified menu to the end of the menu bar.
 void addNotify()
    Overrides JComponent.addNotify to register this menu bar with the current keyboard manager.
 AccessibleContext getAccessibleContext()
    Gets the AccessibleContext associated with this JMenuBar.
 Component getComponent()
    Implemented to be a MenuElement.
 Component getComponentAtIndex(int i)
    Deprecated. replaced by getComponent(int i)
 int getComponentIndex(Component c)
    Returns the index of the specified component.
 JMenu getHelpMenu()
    Gets the help menu for the menu bar.
 Insets getMargin()
    Returns the margin between the menubar's border and its menus.
 JMenu getMenu(int index)
    Returns the menu at the specified position in the menu bar.
 int getMenuCount()
    Returns the number of items in the menu bar.
 SingleSelectionModel getSelectionModel()
    Returns the model object that handles single selections.
 MenuElement[] getSubElements()
    Implemented to be a MenuElement -- returns the menus in this menu bar.
 MenuBarUI getUI()
    Returns the menubar's current UI.
 String getUIClassID()
    Returns the name of the L&F class that renders this component.
 boolean isBorderPainted()
    Returns true if the menu bars border should be painted.
 boolean isSelected()
    Returns true if the menu bar currently has a component selected.
 void menuSelectionChanged(boolean isIncluded)
    Implemented to be a MenuElement -- does nothing.
protected  void paintBorder(Graphics g)
    Paints the menubar's border if BorderPainted property is true.
protected  String paramString()
    Returns a string representation of this JMenuBar.
protected  boolean processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)
    Subclassed to check all the child menus.
 void processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)
    Implemented to be a MenuElement -- does nothing.
 void processMouseEvent(MouseEvent event, MenuElement[] path, MenuSelectionManager manager)
    Implemented to be a MenuElement -- does nothing.
 void removeNotify()
    Overrides JComponent.removeNotify to unregister this menu bar with the current keyboard manager.
 void setBorderPainted(boolean b)
    Sets whether the border should be painted.
 void setHelpMenu(JMenu menu)
    Sets the help menu that appears when the user selects the "help" option in the menu bar.
 void setMargin(Insets m)
    Sets the margin between the menubar's border and its menus.
 void setSelected(Component sel)
    Sets the currently selected component, producing a a change to the selection model.
 void setSelectionModel(SingleSelectionModel model)
    Sets the model object to handle single selections.
 void setUI(MenuBarUI ui)
    Sets the L&F object that renders this component.
 void updateUI()
    Resets the UI property with a value from the current look and feel.
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls,