Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
Nested Class Summary | |
protected class |
|
Nested classes/interfaces inherited from class javax.swing.AbstractButton | |
AbstractButton.AccessibleAbstractButton , AbstractButton.ButtonChangeListener |
Nested classes/interfaces inherited from class javax.swing.JComponent | |
JComponent.AccessibleJComponent |
Nested classes/interfaces inherited from class java.awt.Container | |
Container.AccessibleAWTContainer |
Nested classes/interfaces inherited from class java.awt.Component | |
Component.AccessibleAWTComponent , Component.BltBufferStrategy , Component.FlipBufferStrategy |
Field Summary |
Fields inherited from class javax.swing.JComponent | |
TOOL_TIP_TEXT_KEY , UNDEFINED_CONDITION , WHEN_ANCESTOR_OF_FOCUSED_COMPONENT , WHEN_FOCUSED , WHEN_IN_FOCUSED_WINDOW , accessibleContext , listenerList , ui |
Fields inherited from class java.awt.Component | |
BOTTOM_ALIGNMENT , CENTER_ALIGNMENT , LEFT_ALIGNMENT , RIGHT_ALIGNMENT , TOP_ALIGNMENT |
Fields inherited from interface java.awt.image.ImageObserver | |
ABORT , ALLBITS , ERROR , FRAMEBITS , HEIGHT , PROPERTIES , SOMEBITS , WIDTH |
Fields inherited from interface javax.swing.SwingConstants | |
BOTTOM , CENTER , EAST , HORIZONTAL , LEADING , LEFT , NEXT , NORTH , NORTH_EAST , NORTH_WEST , PREVIOUS , RIGHT , SOUTH , SOUTH_EAST , SOUTH_WEST , TOP , TRAILING , VERTICAL , WEST |
Constructor Summary | |
| |
Method Summary | |
void |
|
void |
|
protected void |
|
protected PropertyChangeListener |
|
protected void |
|
protected void |
|
protected void |
|
protected void |
|
protected void |
|
protected void |
|
protected void |
|
KeyStroke |
|
AccessibleContext |
|
Component |
|
MenuDragMouseListener[] |
|
MenuKeyListener[] |
|
MenuElement[] |
|
String |
|
protected void | |
boolean |
|
void |
|
protected String |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
void |
|
Methods inherited from class java.lang.Object | |
clone , equals , extends Object> getClass , finalize , hashCode , notify , notifyAll , toString , wait , wait , wait |
public JMenuItem(String text)
Creates a new JMenuItem with the given label.
- Parameters:
text
- label for the menu item
public JMenuItem(String text, int mnemonic)
Creates a new JMenuItem object.
- Parameters:
text
- label for this menu itemmnemonic
- - Single key that can be used with a look-and-feel meta key to activate this menu item. However menu item should be visible on the screen when mnemonic is used.
public JMenuItem(String text, Icon icon)
Creates a new JMenuItem with specified text and icon. Text is displayed to the left of icon by default.
- Parameters:
text
- label for this menu itemicon
- icon that will be displayed on this menu item
public JMenuItem(Action action)
Creates a new JMenuItem associated with the specified action.
- Parameters:
action
- action for this menu item
public void addMenuDragMouseListener(MenuDragMouseListener listener)
Adds a MenuDragMouseListener to this menu item. When mouse is dragged over the menu item the MenuDragMouseEvents will be fired, and these listeners will be called.
- Parameters:
listener
- The new listener to add
public void addMenuKeyListener(MenuKeyListener listener)
Adds an MenuKeyListener to this menu item. This listener will be invoked when MenuKeyEvents will be fired by this menu item.
- Parameters:
listener
- The new listener to add
protected void configurePropertiesFromAction(Action action)
Configures menu items' properties from properties of the specified action. This method overrides configurePropertiesFromAction from AbstractButton to also set accelerator property.
- Overrides:
- configurePropertiesFromAction in interface AbstractButton
- Parameters:
action
- action to configure properties from
protected PropertyChangeListener createActionPropertyChangeListener(Action action)
Creates PropertyChangeListener to listen for the changes in action properties.
- Overrides:
- createActionPropertyChangeListener in interface AbstractButton
- Parameters:
action
- action to listen to for property changes
- Returns:
- $PropertyChangeListener$ Listener that listens to changes in action properties.
protected void fireMenuDragMouseDragged(MenuDragMouseEvent event)
Fires MenuDragMouseEvent to all of the menuItem's MouseInputListeners.
- Parameters:
event
- The event signifying that mouse is being dragged over the menuItem
protected void fireMenuDragMouseEntered(MenuDragMouseEvent event)
Fires MenuDragMouseEvent to all of the menuItem's MouseInputListeners.
- Parameters:
event
- The event signifying that mouse entered menuItem while it was dragged
protected void fireMenuDragMouseExited(MenuDragMouseEvent event)
Fires MenuDragMouseEvent to all of the menuItem's MouseInputListeners.
- Parameters:
event
- The event signifying that mouse has exited menu item, while it was dragged
protected void fireMenuDragMouseReleased(MenuDragMouseEvent event)
This method fires a MenuDragMouseEvent to all the MenuItem's MouseInputListeners.
- Parameters:
event
- The event signifying that mouse was released while it was dragged over the menuItem
protected void fireMenuKeyPressed(MenuKeyEvent event)
This method fires a MenuKeyEvent to all the MenuItem's MenuKeyListeners.
- Parameters:
event
- The event signifying that key associated with this menu was pressed
protected void fireMenuKeyReleased(MenuKeyEvent event)
This method fires a MenuKeyEvent to all the MenuItem's MenuKeyListeners.
- Parameters:
event
- The event signifying that key associated with this menu was released
protected void fireMenuKeyTyped(MenuKeyEvent event)
This method fires a MenuKeyEvent to all the MenuItem's MenuKeyListeners.
- Parameters:
event
- The event signifying that key associated with this menu was typed. The key is typed when it was pressed and then released
public KeyStroke getAccelerator()
Return accelerator for this menu item.
- Returns:
- $KeyStroke$ accelerator for this menu item.
public AccessibleContext getAccessibleContext()
Returns the object that provides accessibility features for thisJMenuItem
component.
- Specified by:
- getAccessibleContext in interface Accessible
- Overrides:
- getAccessibleContext in interface JComponent
- Returns:
- The accessible context (an instance of
JMenuItem.AccessibleJMenuItem
).
public Component getComponent()
Returns reference to the component that will paint this menu item.
- Specified by:
- getComponent in interface MenuElement
- Returns:
- $Component$ Component that will paint this menu item. Simply returns reference to this menu item.
public MenuDragMouseListener[] getMenuDragMouseListeners()
Returns all added MenuDragMouseListener objects.
- Returns:
- an array of listeners
- Since:
- 1.4
public MenuKeyListener[] getMenuKeyListeners()
Returns all added MenuKeyListener objects.
- Returns:
- an array of listeners
- Since:
- 1.4
public MenuElement[] getSubElements()
Method of the MenuElement interface.
- Specified by:
- getSubElements in interface MenuElement
- Returns:
- $MenuElement[]$ Returns array of sub-components for this menu item. By default menuItem doesn't have any subcomponents and so empty array is returned instead.
public String getUIClassID()
This method returns a name to identify which look and feel class will be the UI delegate for the menuItem.
- Overrides:
- getUIClassID in interface JComponent
- Returns:
- The Look and Feel classID. "MenuItemUI"
protected void init(String text, Icon icon)
Initializes this menu item
- Overrides:
- init in interface AbstractButton
- Parameters:
text
- label for this menu itemicon
- icon to be displayed for this menu item
public boolean isArmed()
Returns true if button's model is armed and false otherwise. The button model is armed if menu item has focus or it is selected.
- Returns:
- $boolean$ true if button's model is armed and false otherwise
public void menuSelectionChanged(boolean changed)
Method of the MenuElement interface. This method is invoked by MenuSelectionManager when selection of this menu item has changed. If this menu item was selected then arm it's model, and disarm the model otherwise. The menu item is considered to be selected, and thus highlighted when its model is armed.
- Specified by:
- menuSelectionChanged in interface MenuElement
- Parameters:
changed
- indicates selection status of this menu item. If changed is true then menu item is selected and deselected otherwise.
protected String paramString()
Returns a string describing the attributes for theJMenuItem
component, for use in debugging. The return value is guaranteed to be non-null
, but the format of the string may vary between implementations.
- Overrides:
- paramString in interface AbstractButton
- Returns:
- A string describing the attributes of the
JMenuItem
.
public void processKeyEvent(KeyEvent event, MenuElement[] path, MenuSelectionManager manager)
Process key events forwarded from MenuSelectionManager.
- Specified by:
- processKeyEvent in interface MenuElement
- Parameters:
event
- event forwarded from MenuSelectionManagerpath
- path to the menu element from which event was generatedmanager
- MenuSelectionManager for the current menu hierarchy
public void processMenuDragMouseEvent(MenuDragMouseEvent event)
This method fires MenuDragMouseEvents to registered listeners. Different types of MenuDragMouseEvents are fired depending on the observed mouse event.
- Parameters:
event
- Mouse
public void processMenuKeyEvent(MenuKeyEvent event)
This method fires MenuKeyEvent to registered listeners. Different types of MenuKeyEvents are fired depending on the observed key event.
- Parameters:
event
- DOCUMENT ME!
public void processMouseEvent(MouseEvent ev, MenuElement[] path, MenuSelectionManager manager)
Process mouse events forwarded from MenuSelectionManager.
- Specified by:
- processMouseEvent in interface MenuElement
- Parameters:
ev
- event forwarded from MenuSelectionManagerpath
- path to the menu element from which event was generatedmanager
- MenuSelectionManager for the current menu hierarchy
public void removeMenuDragMouseListener(MenuDragMouseListener listener)
Removes a MenuDragMouseListener from the menuItem's listener list.
- Parameters:
listener
- The listener to remove
public void removeMenuKeyListener(MenuKeyListener listener)
Removes an MenuKeyListener from the menuItem's listener list.
- Parameters:
listener
- The listener to remove
public void setAccelerator(KeyStroke keystroke)
Sets the key combination which invokes the menu item's action listeners without navigating the menu hierarchy. Note that when the keyboard accelerator is typed, it will work whether or not the menu is currently displayed.
- Parameters:
keystroke
- accelerator for this menu item.
public void setArmed(boolean armed)
Sets menuItem's "ARMED" property
- Parameters:
armed
- DOCUMENT ME!
public void setEnabled(boolean enabled)
Enable or disable menu item. When menu item is disabled, its text and icon are grayed out if they exist.
- Overrides:
- setEnabled in interface AbstractButton
- Parameters:
enabled
- if true enable menu item, and disable otherwise.
public void setUI(MenuItemUI ui)
Set the "UI" property of the menu item, which is a look and feel class responsible for handling menuItem's input events and painting it.
- Parameters:
ui
- The new "UI" property
public void updateUI()
This method sets this menuItem's UI to the UIManager's default for the current look and feel.
- Overrides:
- updateUI in interface AbstractButton