java.lang.Object java.awt.MenuComponent java.awt.MenuItem java.awt.Menu
public class Menu
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
() Deprecated. As of JDK version 1.1, replaced by getItemCount(). |
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 , deleteShortcut , disable , disableEvents , enable , enable , enableEvents , getActionCommand , getActionListeners , getLabel , getListeners , getShortcut , isEnabled , processActionEvent , processEvent , removeActionListener , setActionCommand , setEnabled , setLabel , setShortcut |
Methods inherited from class java.awt. MenuComponent |
---|
dispatchEvent , getFont , getName , getParent , getPeer , getTreeLock , postEvent , setFont , setName , toString |
Methods inherited from class java.lang. Object |
---|
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait |
Methods inherited from interface java.awt. MenuContainer |
---|
getFont , postEvent |
Constructor Detail |
---|
public Menu() throws HeadlessException
public Menu(String label) throws HeadlessException
public Menu(String label, boolean tearOff) throws HeadlessException
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.
Method Detail |
---|
public void addNotify()
public void removeNotify()
public boolean isTearOff()
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.
public int getItemCount()
@Deprecated public int countItems()
public MenuItem getItem(int index)
public MenuItem add(MenuItem mi)
public void add(String label)
public void insert(MenuItem menuitem, int index)
public void insert(String label, int index)
public void addSeparator()
public void insertSeparator(int index)
public void remove(int index)
public void remove(MenuComponent item)
public void removeAll()
public String paramString()
public AccessibleContext getAccessibleContext()