This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
Overview  Package   Class 
 PREV CLASS   NEXT CLASS FRAMES   NO FRAMES 
SUMMARY: NESTED | FIELD | CONSTR | METHOD  DETAIL: FIELD | CONSTR | METHOD 

java.awt
class Menu

java.lang.Object extended by java.awt.MenuComponent extended by java.awt.MenuItem extended by java.awt.Menu
All Implemented Interfaces:
MenuContainer, Serializable, Accessible
Direct Known Subclasses:
PopupMenu
Most common way to construct:

Menu fileMenu = new Menu("File");

Based on 95 examples 

public class Menu
extends MenuItem
implements MenuContainer, Accessible

A Menu object is a pull-down menu component that is deployed from a menu bar.

A menu can optionally be a tear-off menu. A tear-off menu can be opened and dragged away from its parent menu bar or menu. It remains on the screen after the mouse button has been released. The mechanism for tearing off a menu is platform dependent, since the look and feel of the tear-off menu is determined by its peer. On platforms that do not support tear-off menus, the tear-off property is ignored.

Each item in a menu must belong to the MenuItem class. It can be an instance of MenuItem, a submenu (an instance of Menu), or a check box (an instance of CheckboxMenuItem).

Nested Class Summary
protected class
Menu.AccessibleAWTMenu

           Inner class of Menu used to provide default support for accessibility.
Nested classes/interfaces inherited from class java.awt.MenuItem
MenuItem.AccessibleAWTMenuItem
 
Nested classes/interfaces inherited from class java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent
   
Constructor Summary
Menu()

          Constructs a new menu with an empty label.
Menu(String label)

          Constructs a new menu with the specified label.
Menu(String label, boolean tearOff)

          Constructs a new menu with the specified label, indicating whether the menu can be torn off.
 
Method Summary
 MenuItem
add(MenuItem mi)

          Adds the specified menu item to this menu.
 void
add(String label)

          Adds an item with the specified label to this menu.
 void
addNotify()

          Creates the menu's peer.
 void
addSeparator()

          Adds a separator line, or a hypen, to the menu at the current position.
 int
countItems()

          
 AccessibleContext
getAccessibleContext()

          Gets the AccessibleContext associated with this Menu.
 MenuItem
getItem(int index)

          Gets the item located at the specified index of this menu.
 int
getItemCount()

          Get the number of items in this menu.
 void
insert(MenuItem menuitem, int index)

          Inserts a menu item into this menu at the specified position.
 void
insert(String label, int index)

          Inserts a menu item with the specified label into this menu at the specified position.
 void
insertSeparator(int index)

          Inserts a separator at the specified position.
 boolean
isTearOff()

          Indicates whether this menu is a tear-off menu.
 String
paramString()

          Returns a string representing the state of this Menu.
 void
remove(int index)

          Removes the menu item at the specified index from this menu.
 void
remove(MenuComponent item)

          Removes the specified menu item from this menu.
 void
removeAll()

          Removes all items from this menu.
 void
removeNotify()

          Removes the menu's peer.
 
Methods inherited from class java.awt.MenuItem
addActionListener, addNotify, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getAccessibleContext, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, paramString, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
 
Methods inherited from class java.awt.MenuComponent
dispatchEvent, getAccessibleContext, getFont, getName, getParent, getPeer, getTreeLock, paramString, postEvent, processEvent, removeNotify, setFont, setName, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Menu

public Menu()
     throws HeadlessException
Constructs a new menu with an empty label. This menu is not a tear-off menu.

Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true.

Menu

public Menu(String label)
     throws HeadlessException
Constructs a new menu with the specified label. This menu is not a tear-off menu.

Parameters:
label - the menu's label in the menu bar, or in another menu of which this menu is a submenu.
Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true.

Menu

public Menu(String label,
            boolean tearOff)
     throws HeadlessException
Constructs a new menu with the specified label, indicating whether the menu can be torn off.

Tear-off functionality may not be supported by all implementations of AWT. If a particular implementation doesn't support tear-off menus, this value is silently ignored.

Parameters:
label - the menu's label in the menu bar, or in another menu of which this menu is a submenu.
tearOff - if true, the menu is a tear-off menu.
Throws:
HeadlessException - if GraphicsEnvironment.isHeadless() returns true.
Method Detail

add

public MenuItem add(MenuItem mi)
Adds the specified menu item to this menu. If the menu item has been part of another menu, removes it from that menu.

Parameters:
mi - the menu item to be added
Returns:
the menu item added

add

public void add(String label)
Adds an item with the specified label to this menu.

Parameters:
label - the text on the item

addNotify

public void addNotify()
Creates the menu's peer. The peer allows us to modify the appearance of the menu without changing its functionality.

Overrides:
addNotify in class MenuItem

addSeparator

public void addSeparator()
Adds a separator line, or a hypen, to the menu at the current position.

countItems

public int countItems()

getAccessibleContext

public AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this Menu. For menus, the AccessibleContext takes the form of an AccessibleAWTMenu. A new AccessibleAWTMenu instance is created if necessary.

Overrides:
getAccessibleContext in class MenuItem
Returns:
an AccessibleAWTMenu that serves as the AccessibleContext of this Menu

getItem

public MenuItem getItem(int index)
Gets the item located at the specified index of this menu.

Parameters:
index - the position of the item to be returned.
Returns:
the item located at the specified index.

getItemCount

public int getItemCount()
Get the number of items in this menu.

Returns:
the number of items in this menu.

insert

public void insert(MenuItem menuitem,
                   int index)
Inserts a menu item into this menu at the specified position.

Parameters:
menuitem - the menu item to be inserted.
index - the position at which the menu item should be inserted.

insert

public void insert(String label,
                   int index)
Inserts a menu item with the specified label into this menu at the specified position. This is a convenience method for insert(menuItem, index).

Parameters:
label - the text on the item
index - the position at which the menu item should be inserted

insertSeparator

public void insertSeparator(int index)
Inserts a separator at the specified position.

Parameters:
index - the position at which the menu separator should be inserted.

isTearOff

public boolean isTearOff()
Indicates whether this menu is a tear-off menu.

Tear-off functionality may not be supported by all implementations of AWT. If a particular implementation doesn't support tear-off menus, this value is silently ignored.

Returns:
true if this is a tear-off menu; false otherwise.

paramString

public String paramString()
Returns a string representing the state of this Menu. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not be null.

Overrides:
paramString in class MenuItem
Returns:
the parameter string of this menu

remove

public void remove(int index)
Removes the menu item at the specified index from this menu.

Parameters:
index - the position of the item to be removed.

remove

public void remove(MenuComponent item)
Removes the specified menu item from this menu.

Parameters:
item - the item to be removed from the menu. If item is null or is not in this menu, this method does nothing.

removeAll

public void removeAll()
Removes all items from this menu.

removeNotify

public void removeNotify()
Removes the menu's peer. The peer allows us to modify the appearance of the menu without changing its functionality.

Overrides:
removeNotify in class MenuComponent
Overview  Package   Class 
 PREV CLASS   NEXT CLASS FRAMES   NO FRAMES 
SUMMARY: NESTED | FIELD | CONSTR | METHOD  DETAIL: FIELD | CONSTR | METHOD 
This documentation differs from the official API. Jadeite adds extra features to the API including: variable font sizes, constructions examples, placeholders for classes and methods, and auto-generated “See Also” links. Additionally it is missing some items found in standard Javadoc documentation, including: generics type information, “Deprecated” tags and comments, “See Also” links, along with other minor differences. Please send any questions or feedback to bam@cs.cmu.edu.
This page displays the Jadeite version of the documention, which is derived from the offical documentation that contains this copyright notice:
Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
The official Sun™ documentation can be found here at http://java.sun.com/javase/6/docs/api/.