Adds the specified menu item to this menu.

  Adds the specified menu item to this menu. If the
menu item has been part of another menu, removes it
from that menu.
Returns: the menu item added
Parameters:
- mi - the menu item to be added
See Also: Menu.insert(java.lang.String, int), Menu.insert(java.awt.MenuItem, int),

  Adds an item with the specified label to this menu.

  Adds an item with the specified label to this menu.
Parameters:
- label - the text on the item
See Also: Menu.insert(java.lang.String, int), Menu.insert(java.awt.MenuItem, int),

  Adds the specified action listener to receive action events from this menu item.

  Adds the specified action listener to receive action events from this menu item. If l is null, no exception is thrown and no action is performed.

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the action listener.
Since: JDK1.1
See Also: MenuItem.removeActionListener(java.awt.event.ActionListener), MenuItem.getActionListeners(), ActionEvent, ActionListener,

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

  Adds a separator line, or a hypen, to the menu at the current position.
See Also: Menu.insertSeparator(int),

  Delete any MenuShortcut object associated with this menu item.

  Delete any MenuShortcut object associated
with this menu item.
Since: JDK1.1

  Disables event delivery to this menu item for events defined by the specified event mask parameter.

  Disables event delivery to this menu item for events
defined by the specified event mask parameter.
Parameters:
- eventsToDisable - the event mask defining the event types
Since: JDK1.1
See Also: MenuItem.processEvent(java.awt.AWTEvent), MenuItem.enableEvents(long), Component.disableEvents(long),

  Delivers an event to this component or one of its sub components.

  Delivers an event to this component or one of its sub components.
Parameters:
- e - the event

  Enables event delivery to this menu item for events to be defined by the specified event mask parameter

  Enables event delivery to this menu item for events to be defined by the specified event mask parameter

Since event types are automatically enabled when a listener for that type is added to the menu item, this method only needs to be invoked by subclasses of MenuItem which desire to have the specified event types delivered to processEvent regardless of whether a listener is registered.
Parameters:
- eventsToEnable - the event mask defining the event types
Since: JDK1.1
See Also: MenuItem.processEvent(java.awt.AWTEvent), MenuItem.disableEvents(long), Component.enableEvents(long),

  Defined in MenuComponent.

  Defined in MenuComponent. Overridden here.

  Gets the index of this object in its accessible parent.

  Gets the index of this object in its accessible parent.
Returns: -1 if this object does not have an accessible parent; otherwise, the index of the child in its accessible parent.

  Gets the state of this object.

  Gets the state of this object.
Returns: an instance of AccessibleStateSet containing the current state set of the object
See Also: AccessibleState,

  Gets the command name of the action event that is fired by this menu item.

  Gets the command name of the action event that is fired
by this menu item.
Since: JDK1.1
See Also: MenuItem.setActionCommand(java.lang.String),

  Returns an array of all the action listeners registered on this menu item.

  Returns an array of all the action listeners
registered on this menu item.
Returns: all of this menu item's ActionListeners or an empty array if no action listeners are currently registered
Since: 1.4
See Also: MenuItem.addActionListener(java.awt.event.ActionListener), MenuItem.removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListener,

  Gets the font used for this menu component.

  Gets the font used for this menu component.
Returns: the font used in this menu component, if there is one; null otherwise
See Also: MenuComponent.setFont(java.awt.Font),

  Gets the item located at the specified index of this menu.

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

  Get the number of items in this menu.

  Get the number of items in this menu.
Returns: the number of items in this menu.
Since: JDK1.1

  Gets the label for this menu item.

  Gets the label for this menu item.
Returns: the label of this menu item, or null if this menu item has no label.
Since: JDK1.0
See Also: MenuItem.setLabel(java.lang.String),

  Returns an array of all the objects currently registered as FooListeners upon this MenuItem.

  Returns an array of all the objects currently registered as FooListeners upon this MenuItem. FooListeners are registered using the addFooListener method.

You can specify the listenerType argument with a class literal, such as FooListener.class. For example, you can query a MenuItem m for its action listeners with the following code:

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

If no such listeners exist, this method returns an empty array.
Returns: an array of all objects registered as FooListeners on this menu item, or an empty array if no such listeners have been added
Parameters:
- listenerType - the type of listeners requested; this parameter should specify an interface that descends from java.util.EventListener
Throws:
- ClassCastException - if listenerType doesn't specify a class or interface that implements java.util.EventListener
Since: 1.3
See Also: MenuItem.getActionListeners(),

  Gets the name of the menu component.

  Gets the name of the menu component.
Returns: the name of the menu component
Since: JDK1.1
See Also: MenuComponent.setName(java.lang.String),

  Get the MenuShortcut object associated with this menu item,

  Get the MenuShortcut object associated with this
menu item,
Returns: the menu shortcut associated with this menu item, or null if none has been specified.
Since: JDK1.1
See Also: MenuItem.setShortcut(java.awt.MenuShortcut),

  Gets this component's locking object (the object that owns the thread sychronization monitor) for AWT component-tree and layout operations.

  Gets this component's locking object (the object that owns the thread
sychronization monitor) for AWT component-tree and layout
operations.
Returns: this component's locking object

  Inserts a menu item into this menu at the specified position.

  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.
Throws:
- IllegalArgumentException - if the value of index is less than zero
Since: JDK1.1
See Also: Menu.add(java.lang.String), Menu.add(java.awt.MenuItem),

  Inserts a menu item with the specified label into this menu at the specified position.

  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
Throws:
- IllegalArgumentException - if the value of index is less than zero
Since: JDK1.1
See Also: Menu.add(java.lang.String), Menu.add(java.awt.MenuItem),

  Inserts a separator at the specified position.

  Inserts a separator at the specified position.
Parameters:
- index - the position at which the menu separator should be inserted.
Throws:
- IllegalArgumentException - if the value of index is less than 0.
Since: JDK1.1
See Also: Menu.addSeparator(),

  Checks whether this menu item is enabled.

  Checks whether this menu item is enabled.
Since: JDK1.0
See Also: MenuItem.setEnabled(boolean),

  Indicates whether this menu is a tear-off menu.

  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.

  Returns a string representing the state of this Menu.

  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.
Returns: the parameter string of this menu

  Posts the specified event to the menu.

  Posts the specified event to the menu.
This method is part of the Java 1.0 event system
and it is maintained only for backwards compatibility.
Its use is discouraged, and it may not be supported
in the future.
Parameters:
- evt - the event which is to take place

  Processes action events occurring on this menu item, by dispatching them to any registered ActionListener objects.

  Processes action events occurring on this menu item, by dispatching them to any registered ActionListener objects. This method is not called unless action events are enabled for this component. Action events are enabled when one of the following occurs:

• An ActionListener object is registered via addActionListener.
• Action events are enabled via enableEvents.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the action event
Since: JDK1.1
See Also: ActionEvent, ActionListener, MenuItem.enableEvents(long),

  Processes events on this menu item.

  Processes events on this menu item. If the event is an instance of ActionEvent, it invokes processActionEvent, another method defined by MenuItem.

Currently, menu items only support action events.

Note that if the event parameter is null the behavior is unspecified and may result in an exception.
Parameters:
- e - the event
Since: JDK1.1
See Also: MenuItem.processActionEvent(java.awt.event.ActionEvent),

  Removes the menu item at the specified index from this menu.

  Removes the menu item at the specified index from this menu.
Parameters:
- index - the position of the item to be removed.

  Removes the specified menu item from this menu.

  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.

  Removes the specified action listener so it no longer receives action events from this menu item.

  Removes the specified action listener so it no longer receives action events from this menu item. If l is null, no exception is thrown and no action is performed.

Refer to AWT Threading Issues for details on AWT's threading model.
Parameters:
- l - the action listener.
Since: JDK1.1
See Also: MenuItem.addActionListener(java.awt.event.ActionListener), MenuItem.getActionListeners(), ActionEvent, ActionListener,

  Removes all items from this menu.

  Removes all items from this menu.
Since: JDK1.0.

  Removes the menu's peer.

  Removes the menu's peer. The peer allows us to modify the appearance
of the menu without changing its functionality.

  Sets the command name of the action event that is fired by this menu item.

  Sets the command name of the action event that is fired by this menu item.

By default, the action command is set to the label of the menu item.
Parameters:
- command - the action command to be set for this menu item.
Since: JDK1.1
See Also: MenuItem.getActionCommand(),

  Sets whether or not this menu item can be chosen.

  Sets whether or not this menu item can be chosen.
Parameters:
- b - if true, enables this menu item; if false, disables it.
Since: JDK1.1
See Also: MenuItem.isEnabled(),

  Sets the font to be used for this menu component to the specified font.

  Sets the font to be used for this menu component to the specified font. This font is also used by all subcomponents of this menu component, unless those subcomponents specify a different font.

Some platforms may not support setting of all font attributes of a menu component; in such cases, calling setFont will have no effect on the unsupported font attributes of this menu component. Unless subcomponents of this menu component specify a different font, this font will be used by those subcomponents if supported by the underlying platform.
Parameters:
- f - the font to be set
See Also: MenuComponent.getFont(), Font.getAttributes(), TextAttribute,

  Sets the label for this menu item to the specified label.

  Sets the label for this menu item to the specified label.
Parameters:
- label - the new label, or null for no label.
Since: JDK1.0
See Also: MenuItem.getLabel(),

  Sets the name of the component to the specified string.

  Sets the name of the component to the specified string.
Parameters:
- name - the name of the menu component
Since: JDK1.1
See Also: MenuComponent.getName(),

  Set the MenuShortcut object associated with this menu item.

  Set the MenuShortcut object associated with this
menu item. If a menu shortcut is already associated with
this menu item, it is replaced.
Parameters:
- s - the menu shortcut to associate with this menu item.
Since: JDK1.1
See Also: MenuItem.getShortcut(),

  Returns a representation of this menu component as a string.

  Returns a representation of this menu component as a string.
Returns: a string representation of this menu component