MenuContainer
, Serializable
, Accessible
PopupMenu
public class Menu extends MenuItem implements MenuContainer, Accessible
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
).
Modifier and Type | Class | Description |
---|---|---|
protected class |
Menu.AccessibleAWTMenu |
Inner class of Menu used to provide default support for accessibility. |
MenuItem.AccessibleAWTMenuItem
MenuComponent.AccessibleAWTMenuComponent
Constructor | Description |
---|---|
Menu() |
Constructs a new menu with an empty label. |
Menu |
Constructs a new menu with the specified label. |
Menu |
Constructs a new menu with the specified label, indicating whether the menu can be torn off. |
Modifier and Type | Method | Description |
---|---|---|
MenuItem |
add |
Adds the specified menu item to this menu. |
void |
add |
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 hyphen, to the menu at the current position. |
int |
countItems() |
Deprecated. |
AccessibleContext |
getAccessibleContext() |
Gets the AccessibleContext associated with this Menu. |
MenuItem |
getItem |
Gets the item located at the specified index of this menu. |
int |
getItemCount() |
Get the number of items in this menu. |
void |
insert |
Inserts a menu item into this menu at the specified position. |
void |
insert |
Inserts a menu item with the specified label into this menu at the specified position. |
void |
insertSeparator |
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 |
Removes the menu item at the specified index from this menu. |
void |
remove |
Removes the specified menu item from this menu. |
void |
removeAll() |
Removes all items from this menu. |
void |
removeNotify() |
Removes the menu's peer. |
addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, setFont, setName, toString
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getFont, postEvent
public Menu() throws HeadlessException
HeadlessException
- if GraphicsEnvironment.isHeadless() returns true.public Menu(String label) throws HeadlessException
label
- the menu's label in the menu bar, or in another menu of which this menu is a submenu.HeadlessException
- if GraphicsEnvironment.isHeadless() returns true.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.
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.HeadlessException
- if GraphicsEnvironment.isHeadless() returns true.public void addNotify()
public void removeNotify()
removeNotify
in class MenuComponent
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.
true
if this is a tear-off menu; false
otherwise.public int getItemCount()
@Deprecated public int countItems()
getItemCount()
.public MenuItem getItem(int index)
index
- the position of the item to be returned.public MenuItem add(MenuItem mi)
mi
- the menu item to be addedpublic void add(String label)
label
- the text on the itempublic void insert(MenuItem menuitem, int index)
menuitem
- the menu item to be inserted.index
- the position at which the menu item should be inserted.IllegalArgumentException
- if the value of index
is less than zeropublic void insert(String label, int index)
insert(menuItem, index)
.label
- the text on the itemindex
- the position at which the menu item should be insertedIllegalArgumentException
- if the value of index
is less than zeropublic void addSeparator()
public void insertSeparator(int index)
index
- the position at which the menu separator should be inserted.IllegalArgumentException
- if the value of index
is less than 0.public void remove(int index)
index
- the position of the item to be removed.public void remove(MenuComponent item)
remove
in interface MenuContainer
item
- the item to be removed from the menu. If item
is null
or is not in this menu, this method does nothing.public void removeAll()
public String paramString()
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
.paramString
in class MenuItem
public AccessibleContext getAccessibleContext()
getAccessibleContext
in interface Accessible
getAccessibleContext
in class MenuItem
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.desktop/java/awt/Menu.html
getItemCount()
.