public class JMenuItem extends AbstractButton implements Accessible, MenuElement
| Modifier and Type | Class and Description |
|---|---|
protected class |
JMenuItem.AccessibleJMenuItem
Provides the accessibility features for the
JMenuItem
component. |
AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListenerJComponent.AccessibleJComponentContainer.AccessibleAWTContainerComponent.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategyactionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTYaccessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOWBOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENTBOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WESTABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH| Constructor and Description |
|---|
JMenuItem()
Creates a new JMenuItem object.
|
JMenuItem(Action action)
Creates a new JMenuItem associated with the specified action.
|
JMenuItem(Icon icon)
Creates a new JMenuItem with the given icon.
|
JMenuItem(String text)
Creates a new JMenuItem with the given label.
|
JMenuItem(String text,
Icon icon)
Creates a new JMenuItem with specified text and icon.
|
JMenuItem(String text,
int mnemonic)
Creates a new JMenuItem object.
|
| Modifier and Type | Method and Description |
|---|---|
void |
addMenuDragMouseListener(MenuDragMouseListener listener)
Adds a MenuDragMouseListener to this menu item.
|
void |
addMenuKeyListener(MenuKeyListener listener)
Adds an MenuKeyListener to this menu item.
|
protected void |
configurePropertiesFromAction(Action action)
Configures menu items' properties from properties of the specified action.
|
protected PropertyChangeListener |
createActionPropertyChangeListener(Action action)
Creates PropertyChangeListener to listen for the changes in action
properties.
|
protected void |
fireMenuDragMouseDragged(MenuDragMouseEvent event)
Fires MenuDragMouseEvent to all of the menuItem's MouseInputListeners.
|
protected void |
fireMenuDragMouseEntered(MenuDragMouseEvent event)
Fires MenuDragMouseEvent to all of the menuItem's MouseInputListeners.
|
protected void |
fireMenuDragMouseExited(MenuDragMouseEvent event)
Fires MenuDragMouseEvent to all of the menuItem's MouseInputListeners.
|
protected void |
fireMenuDragMouseReleased(MenuDragMouseEvent event)
This method fires a MenuDragMouseEvent to all the MenuItem's MouseInputListeners.
|
protected void |
fireMenuKeyPressed(MenuKeyEvent event)
This method fires a MenuKeyEvent to all the MenuItem's MenuKeyListeners.
|
protected void |
fireMenuKeyReleased(MenuKeyEvent event)
This method fires a MenuKeyEvent to all the MenuItem's MenuKeyListeners.
|
protected void |
fireMenuKeyTyped(MenuKeyEvent event)
This method fires a MenuKeyEvent to all the MenuItem's MenuKeyListeners.
|
KeyStroke |
getAccelerator()
Return accelerator for this menu item.
|
AccessibleContext |
getAccessibleContext()
Returns the object that provides accessibility features for this
JMenuItem component. |
Component |
getComponent()
Returns reference to the component that will paint this menu item.
|
MenuDragMouseListener[] |
getMenuDragMouseListeners()
Returns all added MenuDragMouseListener objects.
|
MenuKeyListener[] |
getMenuKeyListeners()
Returns all added MenuKeyListener objects.
|
MenuElement[] |
getSubElements()
Method of the MenuElement interface.
|
String |
getUIClassID()
This method returns a name to identify which look and feel class will be
the UI delegate for the menuItem.
|
protected void |
init(String text,
Icon icon)
Initializes this menu item
|
boolean |
isArmed()
Returns true if button's model is armed and false otherwise.
|
void |
menuSelectionChanged(boolean changed)
Method of the MenuElement interface.
|
protected String |
paramString()
Returns a string describing the attributes for the
JMenuItem
component, for use in debugging. |
void |
processKeyEvent(KeyEvent event,
MenuElement[] path,
MenuSelectionManager manager)
Process key events forwarded from MenuSelectionManager.
|
void |
processMenuDragMouseEvent(MenuDragMouseEvent event)
This method fires MenuDragMouseEvents to registered listeners.
|
void |
processMenuKeyEvent(MenuKeyEvent event)
This method fires MenuKeyEvent to registered listeners.
|
void |
processMouseEvent(MouseEvent ev,
MenuElement[] path,
MenuSelectionManager manager)
Process mouse events forwarded from MenuSelectionManager.
|
void |
removeMenuDragMouseListener(MenuDragMouseListener listener)
Removes a MenuDragMouseListener from the menuItem's listener list.
|
void |
removeMenuKeyListener(MenuKeyListener listener)
Removes an MenuKeyListener from the menuItem's listener list.
|
void |
setAccelerator(KeyStroke keystroke)
Sets the key combination which invokes the menu item's action
listeners without navigating the menu hierarchy.
|
void |
setArmed(boolean armed)
Sets menuItem's "ARMED" property
|
void |
setEnabled(boolean enabled)
Enable or disable menu item.
|
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.
|
void |
updateUI()
This method sets this menuItem's UI to the UIManager's default for the
current look and feel.
|
addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPositionaddAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setNextFocusableComponent, setOpaque, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, updateadd, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTreeaction, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCyclepublic JMenuItem()
public JMenuItem(Icon icon)
icon - Icon that will be displayed on the menu itempublic JMenuItem(String text)
text - label for the menu itempublic JMenuItem(Action action)
action - action for this menu itempublic JMenuItem(String text, Icon icon)
text - label for this menu itemicon - icon that will be displayed on this menu itemprotected void init(String text, Icon icon)
init in class AbstractButtontext - label for this menu itemicon - icon to be displayed for this menu itempublic void setUI(MenuItemUI ui)
ui - The new "UI" propertypublic void updateUI()
updateUI in class AbstractButtonpublic String getUIClassID()
getUIClassID in class JComponentJComponent.setUI(javax.swing.plaf.ComponentUI),
JComponent.updateUI()public boolean isArmed()
public void setArmed(boolean armed)
armed - DOCUMENT ME!public void setEnabled(boolean enabled)
setEnabled in class AbstractButtonenabled - if true enable menu item, and disable otherwise.Component.isEnabled(),
Component.isLightweight()public KeyStroke getAccelerator()
public void setAccelerator(KeyStroke keystroke)
keystroke - accelerator for this menu item.protected void configurePropertiesFromAction(Action action)
configurePropertiesFromAction in class AbstractButtonaction - action to configure properties fromprotected PropertyChangeListener createActionPropertyChangeListener(Action action)
createActionPropertyChangeListener in class AbstractButtonaction - action to listen to for property changespublic void processMouseEvent(MouseEvent ev, MenuElement[] path, MenuSelectionManager manager)
processMouseEvent in interface MenuElementev - event forwarded from MenuSelectionManagerpath - path to the menu element from which event was generatedmanager - MenuSelectionManager for the current menu hierarchypublic void processKeyEvent(KeyEvent event, MenuElement[] path, MenuSelectionManager manager)
processKeyEvent in interface MenuElementevent - event forwarded from MenuSelectionManagerpath - path to the menu element from which event was generatedmanager - MenuSelectionManager for the current menu hierarchypublic void processMenuDragMouseEvent(MenuDragMouseEvent event)
event - Mousepublic void processMenuKeyEvent(MenuKeyEvent event)
event - DOCUMENT ME!protected void fireMenuDragMouseEntered(MenuDragMouseEvent event)
event - The event signifying that mouse entered menuItem while it was draggedprotected void fireMenuDragMouseExited(MenuDragMouseEvent event)
event - The event signifying that mouse has exited menu item, while it was draggedprotected void fireMenuDragMouseDragged(MenuDragMouseEvent event)
event - The event signifying that mouse is being dragged over the menuItemprotected void fireMenuDragMouseReleased(MenuDragMouseEvent event)
event - The event signifying that mouse was released while it was dragged over the menuItemprotected void fireMenuKeyPressed(MenuKeyEvent event)
event - The event signifying that key associated with this menu was pressedprotected void fireMenuKeyReleased(MenuKeyEvent event)
event - The event signifying that key associated with this menu was releasedprotected void fireMenuKeyTyped(MenuKeyEvent event)
event - The event signifying that key associated with this menu was typed.
The key is typed when it was pressed and then releasedpublic void menuSelectionChanged(boolean changed)
menuSelectionChanged in interface MenuElementchanged - indicates selection status of this menu item. If changed is
true then menu item is selected and deselected otherwise.public MenuElement[] getSubElements()
getSubElements in interface MenuElementpublic Component getComponent()
getComponent in interface MenuElementpublic void addMenuDragMouseListener(MenuDragMouseListener listener)
listener - The new listener to addpublic void removeMenuDragMouseListener(MenuDragMouseListener listener)
listener - The listener to removepublic MenuDragMouseListener[] getMenuDragMouseListeners()
public void addMenuKeyListener(MenuKeyListener listener)
listener - The new listener to addpublic void removeMenuKeyListener(MenuKeyListener listener)
listener - The listener to removepublic MenuKeyListener[] getMenuKeyListeners()
protected String paramString()
JMenuItem
component, for use in debugging. The return value is guaranteed to be
non-null, but the format of the string may vary between
implementations.paramString in class AbstractButtonJMenuItem.public AccessibleContext getAccessibleContext()
JMenuItem component.getAccessibleContext in interface AccessiblegetAccessibleContext in class JComponentJMenuItem.AccessibleJMenuItem).