---

java.awt
Class Menu

java.lang.Object
 |
 +--java.awt.MenuComponent
 |
 +--java.awt.MenuItem
 |
 +--java.awt.Menu

All Implemented Interfaces:

Accessible, MenuContainer, Serializable

Direct Known Subclasses:

PopupMenu

---

public class Menu

extends MenuItem

implements MenuContainer, Accessible

Unsafe:

See Also:

Serialized Form

---

items

Vector items

A vector of the items that will be part of the Menu.

See Also:

countItems()

---

tearOff

boolean tearOff

This field indicates whether the menu has the tear of property or not. It will be set to true if the menu has the tear off property and it will be set to false> if it does not. A torn off menu can be deleted by a user when it is no longer needed.

See Also:

isTearOff()

---

isHelpMenu

boolean isHelpMenu

This field will be set to true if the Menu in question is actually a help menu. Otherwise it will be set to false.

---

base

private static final String base

---

nameCounter

private static int nameCounter

---

serialVersionUID

private static final long serialVersionUID

---

menuSerializedDataVersion

private int menuSerializedDataVersion

The menu serialized Data Version.

Menu

public Menu()
 throws HeadlessException

Suppressed: Constructs a new menu with an empty label. This menu is not a tear-off menu.

Since:

JDK1.1

See Also:

java.awt.GraphicsEnvironment#isHeadless

---

Menu

public Menu(String label)
 throws HeadlessException

Suppressed: 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.

See Also:

java.awt.GraphicsEnvironment#isHeadless

---

Menu

public Menu(String label,
 boolean tearOff)
 throws HeadlessException

Suppressed: 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.

Since:

JDK1.0.

See Also:

java.awt.GraphicsEnvironment#isHeadless

constructComponentName

String constructComponentName()

Construct a name for this MenuComponent. Called by getName() when the name is null.

Overrides:

constructComponentName in class MenuItem

Returns:

a name for this MenuComponent

---

addNotify

public void addNotify()

Suppressed: 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

---

removeNotify

public void removeNotify()

Suppressed: 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

---

isTearOff

public boolean isTearOff()

Suppressed: 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.

---

getItemCount

public int getItemCount()

Suppressed: Get the number of items in this menu.

Returns:

the number of items in this menu.

Since:

JDK1.1

---

countItems

public int countItems()

Suppressed: @deprecated As of JDK version 1.1, replaced by getItemCount().

---

countItemsImpl

final int countItemsImpl()

---

getItem

public MenuItem getItem(int index)

Suppressed: 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.

---

getItemImpl

final MenuItem getItemImpl(int index)

---

add

public MenuItem add(MenuItem mi)

Suppressed: 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

See Also:

java.awt.Menu#insert(java.lang.String, int), java.awt.Menu#insert(java.awt.MenuItem, int)

---

add

public void add(String label)

Suppressed: Adds an item with the specified label to this menu.

Parameters:

label - the text on the item

See Also:

java.awt.Menu#insert(java.lang.String, int), java.awt.Menu#insert(java.awt.MenuItem, int)

---

insert

public void insert(MenuItem menuitem,
 int index)

Suppressed: 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.

Since:

JDK1.1

See Also:

java.awt.Menu#add(java.lang.String), java.awt.Menu#add(java.awt.MenuItem)

---

insert

public void insert(String label,
 int index)

Suppressed: 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

Since:

JDK1.1

See Also:

java.awt.Menu#add(java.lang.String), java.awt.Menu#add(java.awt.MenuItem)

---

addSeparator

public void addSeparator()

Suppressed: Adds a separator line, or a hypen, to the menu at the current position.

See Also:

java.awt.Menu#insertSeparator(int)

---

insertSeparator

public void insertSeparator(int index)

Suppressed: Inserts a separator at the specified position.

Parameters:

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

Since:

JDK1.1

See Also:

java.awt.Menu#addSeparator

---

remove

public void remove(int index)

Suppressed: 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)

Suppressed: Removes the specified menu item from this menu.

Specified by:

remove in interface MenuContainer

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()

Suppressed: Removes all items from this menu.

Since:

JDK1.0.

---

handleShortcut

boolean handleShortcut(KeyEvent e)

Overrides:

handleShortcut in class MenuItem

---

getShortcutMenuItem

MenuItem getShortcutMenuItem(MenuShortcut s)

Overrides:

getShortcutMenuItem in class MenuItem

---

shortcuts

Enumeration shortcuts()

---

deleteShortcut

void deleteShortcut(MenuShortcut s)

Overrides:

deleteShortcut in class MenuItem

---

writeObject

private void writeObject(ObjectOutputStream s)
 throws IOException

Writes default serializable fields to stream.

Parameters:

s - the ObjectOutputStream to write

IOException

See Also:

AWTEventMulticaster.save(ObjectOutputStream, String, EventListener), readObject(java.io.ObjectInputStream)

---

readObject

private void readObject(ObjectInputStream s)
 throws IOException,
 ClassNotFoundException,
 HeadlessException

Reads the ObjectInputStream. Unrecognized keys or values will be ignored.

Parameters:

s - the ObjectInputStream to read

IOException

ClassNotFoundException

HeadlessException

See Also:

java.awt.GraphicsEnvironment#isHeadless, writeObject(java.io.ObjectOutputStream)

---

paramString

public String paramString()

Suppressed: 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

---

initIDs

private static void initIDs()

Initialize JNI field and method IDs

---

getAccessibleContext

public AccessibleContext getAccessibleContext()

Suppressed: 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.

Specified by:

getAccessibleContext in interface Accessible

Overrides:

getAccessibleContext in class MenuItem

Returns:

an AccessibleAWTMenu that serves as the AccessibleContext of this Menu

---

---