javax.swing
Class JMenuItem

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

All Implemented Interfaces:

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

Direct Known Subclasses:

JCheckBoxMenuItem , JMenu , JRadioButtonMenuItem

public class JMenuItem
extends AbstractButton   
implements Accessible   , MenuElement   

An implementation of an item in a menu. A menu item is essentially a button sitting in a list. When the user selects the "button", the action associated with the menu item is performed. A JMenuItem contained in a JPopupMenu performs exactly that function.

For further documentation and for examples, see How to Use Menus 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:

JPopupMenu , JMenu , JCheckBoxMenuItem , JRadioButtonMenuItem , Serialized Form

Nested Class Summary

protected class

JMenuItem.AccessibleJMenuItem This class implements accessibility support for the JMenuItem class.

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

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

JMenuItem ()
Creates a JMenuItem with no set text or icon.

JMenuItem (Action a)
Creates a menu item whose properties are taken from the specified Action.

JMenuItem (Icon icon)
Creates a JMenuItem with the specified icon.

JMenuItem (String text)
Creates a JMenuItem with the specified text.

JMenuItem (String text, Icon icon)
Creates a JMenuItem with the specified text and icon.

JMenuItem (String text, int mnemonic)
Creates a JMenuItem with the specified text and keyboard mnemonic.

Method Summary

void	addMenuDragMouseListener (MenuDragMouseListener l) Adds a MenuDragMouseListener to the menu item.
void	addMenuKeyListener (MenuKeyListener l) Adds a MenuKeyListener to the menu item.
protected void	configurePropertiesFromAction (Action a) Factory method which sets the ActionEvent source's properties according to values from the Action instance.
protected PropertyChangeListener	createActionPropertyChangeListener (Action a) Factory method which creates the PropertyChangeListener used to update the ActionEvent source as properties change on its Action instance.
protected void	fireMenuDragMouseDragged (MenuDragMouseEvent event) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuDragMouseEntered (MenuDragMouseEvent event) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuDragMouseExited (MenuDragMouseEvent event) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuDragMouseReleased (MenuDragMouseEvent event) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuKeyPressed (MenuKeyEvent event) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuKeyReleased (MenuKeyEvent event) Notifies all listeners that have registered interest for notification on this event type.
protected void	fireMenuKeyTyped (MenuKeyEvent event) Notifies all listeners that have registered interest for notification on this event type.
KeyStroke	getAccelerator () Returns the KeyStroke which serves as an accelerator for the menu item.
AccessibleContext	getAccessibleContext () Returns the AccessibleContext associated with this JMenuItem.
Component	getComponent () Returns the java.awt.Component used to paint this object.
MenuDragMouseListener []	getMenuDragMouseListeners () Returns an array of all the MenuDragMouseListeners added to this JMenuItem with addMenuDragMouseListener().
MenuKeyListener []	getMenuKeyListeners () Returns an array of all the MenuKeyListeners added to this JMenuItem with addMenuKeyListener().
MenuElement []	getSubElements () This method returns an array containing the sub-menu components for this menu component.
String	getUIClassID () Returns the suffix used to construct the name of the L&F class used to render this component.
protected void	init (String text, Icon icon) Initializes the menu item with the specified text and icon.
boolean	isArmed () Returns whether the menu item is "armed".
void	menuSelectionChanged (boolean isIncluded) Called by the MenuSelectionManager when the MenuElement is selected or unselected.
protected String	paramString () Returns a string representation of this JMenuItem.
void	processKeyEvent (KeyEvent e, MenuElement