 |
Chapter 19 java.awt Reference |
 |
Menu
Name
Menu
![[Graphic: Figure from the text]](./figs/menu.gif)
Description
The Menu class represents a group of MenuItem objects. Menus themselves are menu items, allowing you to build multi-level menus. Menus are always attached to MenuBars, which currently can only belong to frames.
Class Definition
public class java.awt.Menu
extends java.awt.MenuItem
implements java.awt.MenuContainer {
// Constructors
public Menu(); 
public Menu (String label);
public Menu (String label, boolean tearOff);
// Instance Methods
public synchronized MenuItem add (MenuItem item);
public void add (String label);
public void addNotify();
public void addSeparator();
public int countItems(); 
public MenuItem getItem (int index);
public int getItemCount();
public void insert (String label, int index);
public synchronized void insert (MenuItem menuitem, int index);
public void insertSeparator (int index);
public boolean isTearOff();
public String paramString();
public synchronized void remove (int index);
public synchronized void remove (MenuComponent component);
public synchronized void removeAll();
public void removeNotify();
}
Constructors
Menu
public Menu()
- Description
-
Constructs a Menu object.
public Menu (String label)
- Parameters
-
- label
-
Text that appears on Menu.
- label
- Description
-
Constructs a Menu object with the given label.
public Menu (String label, boolean tearOff)
- Parameters
-
- label
-
Text that appears on Menu.
- tearOff
-
true to create a tear-off menu, false otherwise.
- label
- Description
-
Constructs a Menu object; this will be a tear-off menu if tearOff is set to true.
Instance Methods
add
public synchronized MenuItem add (MenuItem item)
- Parameters
-
- item
-
A MenuItem to add to the Menu.
- item
- Returns
-
Item just added.
- Description
-
Adds a new item to a Menu.
public void add (String label)
- Parameters
-
- label
-
Text for a MenuItem
- label
- Description
-
Constructs a new MenuItem object with the given label, and adds it to a Menu.
addNotify
public void addNotify()
- Overrides
-
MenuItem.addNotify()
- Description
-
Creates a Menu peer, and peers for all MenuItem objects that appear on it.
addSeparator
public void addSeparator()
- Description
-
Adds a separator bar to the Menu.
countItems
public int countItems()
- Returns
-
The number of items on the menu. Replaced by getItemCount().
getItem
public MenuItem getItem (int index)
- Parameters
-
- index
-
The position of the MenuItem to fetch; the first item has index 0.
- index
- Returns
-
The MenuItem at the designated position.
getItemCount
public int getItemCount()
- Returns
-
The number of items on the menu.
insert
public void insert (String label, int index)
- Parameters
-
- label
-
The label for the new item.
- index
-
The position for the new item.
- label
- Description
-
Adds a new item to this menu.
public synchronized void insert (MenuItem menuitem, int index)
- Parameters
-
- menuitem
-
The item to add.
- index
-
The position for the new item.
- menuitem
- Throws
-
- IllegalArgumentException
-
If index is less than zero.
- IllegalArgumentException
- Description
-
Adds a new item to this menu.
insertSeparator
public void insertSeparator (int index)
- Parameters
-
- index
-
The position for the separator.
- index
- Throws
-
- IllegalArgumentException
-
If index is less than zero.
- IllegalArgumentException
- Description
-
Adds a separator to this menu.
isTearOff
public boolean isTearOff()
- Returns
-
true if the menu is a tear-off menu, false otherwise.
paramString
public String paramString()
- Returns
-
String with current settings of Menu.
- Overrides
-
MenuItem.paramString()
- Description
-
Helper method for toString() to generate string of current settings.
remove
public synchronized void remove (int index)
- Parameters
-
- index
-
The position of the MenuItem to remove.
- index
- Description
-
Removes an item from the Menu.
public synchronized void remove (MenuComponent component)
- Parameters
-
- component
-
The element to remove.
- component
- Implements
-
MenuContainer.remove()
- Description
-
Removes an item from the Menu.
removeAll
public synchronized void removeAll()
- Description
-
Removes all items from the Menu.
removeNotify
public void removeNotify()
- Description
-
Destroys Menu peer, and peers for all MenuItem objects that appear on it.
See Also
Frame, MenuComponent, MenuContainer, MenuItem, String
|
 |
|
| MediaTracker |  |
MenuBar |
