javax.swing
Class JMenu

java.lang.Object   
  java.awt.Component   
      java.awt.Container   
          javax.swing.JComponent   
              javax.swing.AbstractButton   
                  javax.swing.JMenuItem   
                      javax.swing.JMenu

All Implemented Interfaces:

ImageObserver , ItemSelectable , MenuContainer , Serializable , Accessible , MenuElement , SwingConstants

public class JMenu
extends JMenuItem   
implements Accessible   , MenuElement   

An implementation of a menu -- a popup window containing JMenuItems that is displayed when the user selects an item on the JMenuBar. In addition to JMenuItems, a JMenu can also contain JSeparators.

In essence, a menu is a button with an associated JPopupMenu. When the "button" is pressed, the JPopupMenu appears. If the "button" is on the JMenuBar, the menu is a top-level window. If the "button" is another menu item, then the JPopupMenu is "pull-right" menu.

For information and examples of using menus see How to Use Menus, a section in The Java Tutorial.

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 JavaBeans^TM has been added to the java.beans package. Please see XMLEncoder .

See Also:

JMenuItem , JSeparator , JMenuBar , JPopupMenu , Serialized Form

Nested Class Summary

protected class	JMenu.AccessibleJMenu This class implements accessibility support for the JMenu class.
protected class	JMenu.WinListener A listener class that watches for a popup window closing.

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

JMenuItem.AccessibleJMenuItem

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

AbstractButton.AccessibleAbstractButton , AbstractButton.ButtonChangeListener

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.BltBufferStrategy , Component.FlipBufferStrategy

Field Summary

protected JMenu.WinListener

popupListener The window-closing listener for the popup.

Fields inherited from class javax.swing.AbstractButton

actionListener , BORDER_PAINTED_CHANGED_PROPERTY , changeEvent , changeListener , CONTENT_AREA_FILLED_CHANGED_PROPERTY , DISABLED_ICON_CHANGED_PROPERTY , DISABLED_SELECTED_ICON_CHANGED_PROPERTY , FOCUS_PAINTED_CHANGED_PROPERTY , HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY , HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY , ICON_CHANGED_PROPERTY , itemListener , MARGIN_CHANGED_PROPERTY , MNEMONIC_CHANGED_PROPERTY , model , MODEL_CHANGED_PROPERTY , PRESSED_ICON_CHANGED_PROPERTY , ROLLOVER_ENABLED_CHANGED_PROPERTY , ROLLOVER_ICON_CHANGED_PROPERTY , ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY , SELECTED_ICON_CHANGED_PROPERTY , TEXT_CHANGED_PROPERTY , VERTICAL_ALIGNMENT_CHANGED_PROPERTY , VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

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 javax.swing.SwingConstants

BOTTOM , CENTER , EAST , HORIZONTAL , LEADING , LEFT , NEXT , NORTH , NORTH_EAST , NORTH_WEST , PREVIOUS , RIGHT , SOUTH , SOUTH_EAST , SOUTH_WEST , TOP , TRAILING , VERTICAL , WEST

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

JMenu ()
Constructs a new JMenu with no text.

JMenu (Action a)
Constructs a menu whose properties are taken from the Action supplied.

JMenu (String s)
Constructs a new JMenu with the supplied string as its text.

JMenu (String s, boolean b)
Constructs a new JMenu with the supplied string as its text and specified as a tear-off menu or not.

Method Summary

JMenuItem	add (Action a) Creates a new menu item attached to the specified Action object and appends it to the end of this menu.
Component	add (Component c) Appends a component to the end of this menu.
Component	add (Component c, int index) Adds the specified component to this container at the given position.
JMenuItem	add (JMenuItem menuItem) Appends a menu item to the end of this menu.
JMenuItem	add (String s) Creates a new menu item with the specified text and appends it to the end of this menu.
void	addMenuListener (MenuListener l) Adds a listener for menu events.
void	addSeparator () Appends a new separator to the end of the menu.
void	applyComponentOrientation (ComponentOrientation o) Sets the ComponentOrientation property of this menu and all components contained within it.
protected void	configurePropertiesFromAction (Action a) Factory method which sets the ActionEvent source's properties according to values from the Action instance.
protected PropertyChangeListener	createActionChangeListener (JMenuItem b) Returns a properly configured PropertyChangeListener which updates the control as changes to the Action occur.
protected JMenuItem	createActionComponent (Action a) Factory method which creates the JMenuItem for Actions added to the JMenu.
protected JMenu.WinListener	createWinListener (JPopupMenu p) Creates a window-closing listener for the popup.
void	doClick (int pressTime) Programmatically performs a "click".
protected void	fireMenuCanceled () Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuDeselected () Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuSelected () Notifies all listeners that have registered interest for notification on this event type.
AccessibleContext	getAccessibleContext () Gets the AccessibleContext associated with this JMenu.
Component	getComponent () Returns the java.awt.Component used to paint this MenuElement.
int	getDelay () Returns the suggested delay, in milliseconds, before submenus are popped up or down.
JMenuItem	getItem (int pos) Returns the JMenuItem at the specified position.
int	getItemCount () Returns the number of items on the menu, including separators.
Component	getMenuComponent (int n) Returns the component at position n.
int	getMenuComponentCount () Returns the number of components on the menu.
Component []	getMenuComponents () Returns an array of Components of the menu's subcomponents.
MenuListener []	getMenuListeners () Returns an array of all the MenuListeners added to this JMenu with addMenuListener().
JPopupMenu	getPopupMenu () Returns the popupmenu associated with this menu.
protected Point	getPopupMenuOrigin () Computes the origin for the JMenu's popup menu.
MenuElement