Класс JMenuItem

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.AbstractButton
      - javax.swing.JMenuItem

Все реализованные интерфейсы:: ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants

Прямые известные подклассы:: JCheckBoxMenuItem, JMenu, JRadioButtonMenuItem

public class JMenuItem
extends AbstractButton
implements Accessible, MenuElement

Реализация элемента меню. Элемент меню — это по сути кнопка, расположенная в списке. При выборе пользователем «кнопки» выполняется действие, связанное с этим элементом меню. Элемент JMenuItem , находящийся в JPopupMenu, выполняет именно эту функцию.

Элементы меню можно настраивать и в некоторой степени управлять ими с помощью Action. Использование Action с элементом меню имеет много преимуществ помимо непосредственной настройки элемента меню. Обратитесь к Swing-компонентам, поддерживающим Action для получения дополнительной информации, а также вы можете найти больше информации в Как использовать Actions — разделе учебника Java.

Для получения дополнительной документации и примеров см. Как использовать меню в учебнике Java.

Предупреждение: Swing не является потокобезопасным. Для получения дополнительной информации см. Политика потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими на одной версии Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans™ была добавлена в пакет java.beans. Пожалуйста, см. XMLEncoder.

См. также:: JPopupMenu, JMenu, JCheckBoxMenuItem, JRadioButtonMenuItem

Вложенные классы

Модификатор и тип	Класс и описание
`protected class`	`JMenuItem.AccessibleJMenuItem` Этот класс реализует поддержку доступности для класса `JMenuItem`.

Вложенные классы/интерфейсы, унаследованные от класса javax.swing.AbstractButton

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

Вложенные классы/интерфейсы, унаследованные от класса javax.swing.JComponent

JComponent.AccessibleJComponent

Вложенные классы/интерфейсы, унаследованные от класса java.awt.Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, унаследованные от класса java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Поля

Поля, унаследованные от класса javax.swing.AbstractButton

actionListener, 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_PROPERTY

Поля, унаследованные от класса javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, унаследованные от класса java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, унаследованные от интерфейса 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

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Конструкторы

Конструктор и описание
`JMenuItem()` Создает элемент `JMenuItem` без заданного текста или значка.
`JMenuItem(Action a)` Создаёт элемент меню, свойства которого взяты из указанного `Action`.
`JMenuItem(Icon icon)` Создаёт элемент `JMenuItem` с указанным значком.
`JMenuItem(String text)` Создаёт элемент `JMenuItem` с указанным текстом.
`JMenuItem(String text, Icon icon)` Создаёт элемент `JMenuItem` с указанным текстом и значком.
`JMenuItem(String text, int mnemonic)` Создаёт элемент `JMenuItem` с указанным текстом и клавишной комбинацией.

Методы

Модификатор и тип	Метод и описание
`protected void`	`actionPropertyChanged(Action action, String propertyName)` Обновляет состояние кнопки в ответ на изменения свойств связанного действия.
`void`	`addMenuDragMouseListener(MenuDragMouseListener l)` Добавляет `MenuDragMouseListener` к элементу меню.
`void`	`addMenuKeyListener(MenuKeyListener l)` Добавляет `MenuKeyListener` к элементу меню.
`protected void`	`configurePropertiesFromAction(Action a)` Устанавливает свойства этой кнопки в соответствии со свойствами указанного `Action`.
`protected void`	`fireMenuDragMouseDragged(MenuDragMouseEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireMenuDragMouseEntered(MenuDragMouseEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireMenuDragMouseExited(MenuDragMouseEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireMenuDragMouseReleased(MenuDragMouseEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireMenuKeyPressed(MenuKeyEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireMenuKeyReleased(MenuKeyEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`protected void`	`fireMenuKeyTyped(MenuKeyEvent event)` Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события.
`KeyStroke`	`getAccelerator()` Возвращает `KeyStroke`, используемый в качестве ускорителя для элемента меню.
`AccessibleContext`	`getAccessibleContext()` Возвращает `AccessibleContext` , связанный с этим `JMenuItem`.
`Component`	`getComponent()` Возвращает `java.awt.Component`, используемый для отрисовки этого объекта.
`MenuDragMouseListener[]`	`getMenuDragMouseListeners()` Возвращает массив всех `MenuDragMouseListener` , добавленных в этот JMenuItem с помощью addMenuDragMouseListener().
`MenuKeyListener[]`	`getMenuKeyListeners()` Возвращает массив всех `MenuKeyListener` , добавленных в этот JMenuItem с помощью addMenuKeyListener().
`MenuElement[]`	`getSubElements()` Этот метод возвращает массив подменю-компонентов для данного компонента меню.
`String`	`getUIClassID()` Возвращает суффикс, используемый для построения имени класса L&F, используемого для отрисовки этого компонента.
`protected void`	`init(String text, Icon icon)` Инициализирует элемент меню указанным текстом и значком.
`boolean`	`isArmed()` Возвращает, является ли элемент меню «вооружённым».
`void`	`menuSelectionChanged(boolean isIncluded)` Вызывается `MenuSelectionManager` при выборе или отмене выбора `MenuElement`.
`protected String`	`paramString()` Возвращает строковое представление этого `JMenuItem`.
`void`	`processKeyEvent(KeyEvent e, MenuElement[] path, MenuSelectionManager manager)` Обрабатывает событие нажатия клавиши, переданное из `MenuSelectionManager` и изменяет выбор меню, при необходимости, с помощью API `MenuSelectionManager`.
`void`	`processMenuDragMouseEvent(MenuDragMouseEvent e)` Обрабатывает перетаскивание мышью в меню.
`void`	`processMenuKeyEvent(MenuKeyEvent e)` Обрабатывает нажатие клавиши в меню.
`void`	`processMouseEvent(MouseEvent e, MenuElement[] path, MenuSelectionManager manager)` Обрабатывает событие нажатия мыши, переданное из `MenuSelectionManager` и изменяет выбор меню, при необходимости, с помощью API `MenuSelectionManager`.
`void`	`removeMenuDragMouseListener(MenuDragMouseListener l)` Удаляет `MenuDragMouseListener` из элемента меню.
`void`	`removeMenuKeyListener(MenuKeyListener l)` Удаляет `MenuKeyListener` из элемента меню.
`void`	`setAccelerator(KeyStroke keyStroke)` Устанавливает комбинацию клавиш, которая вызывает обработчики действий элемента меню без навигации по иерархии меню.
`void`	`setArmed(boolean b)` Идентифицирует элемент меню как «вооруженный».
`void`	`setEnabled(boolean b)` Включает или отключает элемент меню.
`void`	`setModel(ButtonModel newModel)` Устанавливает модель, которую представляет эта кнопка.
`void`	`setUI(MenuItemUI ui)` Устанавливает объект визуального оформления, который отрисовывает этот компонент.
`void`	`updateUI()` Сбрасывает свойство UI со значением из текущего визуального оформления.

Методы, унаследованные от класса javax.swing.AbstractButton

addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, 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, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

Методы, унаследованные от класса javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Методы, унаследованные от класса java.awt.Container

add, 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, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

Методы, унаследованные от класса java.awt.Component

action, 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, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, 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, 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, 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, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Конструкторы

JMenuItem

public JMenuItem()

Создаёт JMenuItem без заданного текста или значка.

JMenuItem

public JMenuItem(Icon icon)

Создаёт JMenuItem со значком, указанным в качестве параметра.

Параметры:: icon - значок JMenuItem

JMenuItem

public JMenuItem(String text)

Создаёт JMenuItem с указанным текстом.

Параметры:: text - текст JMenuItem

JMenuItem

public JMenuItem(Action a)

Создаёт элемент меню, свойства которого взяты из указанного Action.

Параметры:: a - действие JMenuItem
С тех пор как:: 1.3

JMenuItem

public JMenuItem(String text,
                 Icon icon)

Создаёт JMenuItem с указанным текстом и значком.

Параметры:: text - текст JMenuItem; icon - значок JMenuItem

JMenuItem

public JMenuItem(String text,
                 int mnemonic)

Создаёт JMenuItem с указанным текстом и клавишной комбинацией.

Параметры:: text - текст JMenuItem; mnemonic - клавишная комбинация для JMenuItem

Методы

setModel

public void setModel(ButtonModel newModel)

Устанавливает модель, представляющую эту кнопку.

Переопределяет:: setModel в классе AbstractButton
Параметры:: newModel - новая ButtonModel
См. также:: AbstractButton.getModel()

init

protected void init(String text,
                    Icon icon)

Инициализирует элемент меню с указанным текстом и значком.

Переопределяет:: init в классе AbstractButton
Параметры:: text - текст JMenuItem; icon - значок JMenuItem

setUI

public void setUI(MenuItemUI ui)

Устанавливает объект визуального представления, отображающий этот компонент.

Параметры:: ui - объект L&F
См. также:: UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Сбрасывает свойство UI со значением из текущего визуального представления.

Переопределяет:: updateUI в классе AbstractButton
См. также:: JComponent.updateUI()

getUIClassID

public String getUIClassID()

Возвращает суффикс, используемый для построения имени класса L&F, используемого для отображения этого компонента.

Переопределяет:: getUIClassID в классе JComponent
Возвращает:: строку "MenuItemUI"
См. также:: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setArmed

public void setArmed(boolean b)

Определяет элемент меню как "вооружённый". Если кнопка мыши отпускается, находясь над этим элементом, произойдёт событие действия меню. Если кнопка мыши отпускается в другом месте, событие не произойдёт, и элемент меню будет разоружён.

Параметры:: b - true для вооружения элемента меню, чтобы он мог быть выбран

isArmed

public boolean isArmed()

Возвращает, является ли элемент меню "вооружённым".

Возвращает:: true, если элемент меню вооружён и может быть выбран
См. также:: setArmed(boolean)

setEnabled

public void setEnabled(boolean b)

Включает или выключает элемент меню.

Переопределяет:: setEnabled в классе AbstractButton
Параметры:: b - true для включения элемента
См. также:: Component.isEnabled(), Component.isLightweight()

setAccelerator

public void setAccelerator(KeyStroke keyStroke)

Устанавливает комбинацию клавиш, которая вызывает обработчики событий элемента меню без навигации по иерархии меню. Ответственность UI заключается в установке правильного действия. Обратите внимание, что при нажатии клавишного ускорителя это будет работать, независимо от того, отображается ли в данный момент меню.

Параметры:: keyStroke - KeyStroke который будет использоваться в качестве ускорителя

getAccelerator

public KeyStroke getAccelerator()

Возвращает KeyStroke который служит в качестве ускорителя для элемента меню.

Возвращает:: объект KeyStroke , идентифицирующий клавишу ускорителя

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)

Устанавливает свойства этой кнопки, чтобы соответствовать свойствам указанного Action. Дополнительная информация о том, какие свойства устанавливаются, содержится в Компоненты Swing, поддерживающие Action.

Переопределяет:: configurePropertiesFromAction в классе AbstractButton
Параметры:: a - Action, откуда брать свойства, или null
С тех пор как:: 1.3
См. также:: Action, AbstractButton.setAction(javax.swing.Action)

actionPropertyChanged

protected void actionPropertyChanged(Action action,
                                     String propertyName)

Обновляет состояние кнопки в ответ на изменения свойств связанного действия. Этот метод вызывается из PropertyChangeListener возвращаемого createActionPropertyChangeListener. Подклассы обычно не должны вызывать этот метод. Подклассы, поддерживающие дополнительные Action свойства, должны переопределить этот метод и configurePropertiesFromAction.

Список свойств, которые устанавливает этот метод, приведен в таблице по адресу Компоненты Swing, поддерживающие Action.

Переопределяет:: actionPropertyChanged в классе AbstractButton
Параметры:: action - Action связанный с этой кнопкой; propertyName - имя свойства, которое изменилось
С тех пор как:: 1.6
См. также:: Action, AbstractButton.configurePropertiesFromAction(javax.swing.Action)

processMouseEvent

public void processMouseEvent(MouseEvent e,
                              MenuElement[] path,
                              MenuSelectionManager manager)

Обрабатывает событие мыши, переданное из MenuSelectionManager и изменяет выбор меню, при необходимости, используя API MenuSelectionManager.

Примечание: вам не нужно передавать событие подкомпонентам. Это делается автоматически MenuSelectionManager.

Определяет:: processMouseEvent в интерфейсе MenuElement
Параметры:: e - событие MouseEvent; path - массив путей MenuElement; manager - MenuSelectionManager

processKeyEvent

public void processKeyEvent(KeyEvent e,
                            MenuElement[] path,
                            MenuSelectionManager manager)

Обрабатывает событие нажатия клавиши, переданное из MenuSelectionManager и изменяет выбор меню, при необходимости, используя API MenuSelectionManager.

Примечание: вам не нужно передавать событие подкомпонентам. Это делается автоматически MenuSelectionManager.

Определяет:: processKeyEvent в интерфейсе MenuElement
Параметры:: e - событие KeyEvent; path - массив путей MenuElement; manager - MenuSelectionManager

processMenuDragMouseEvent

public void processMenuDragMouseEvent(MenuDragMouseEvent e)

Обрабатывает перетаскивание мышью в меню.

Параметры:: e - объект MenuDragMouseEvent

processMenuKeyEvent

public void processMenuKeyEvent(MenuKeyEvent e)

Обрабатывает нажатие клавиши в меню.

Параметры:: e - объект MenuKeyEvent