Класс JMenuItem

javax.swing.JMenuItem

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

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

@JavaBean(defaultProperty="UIClassID", description="An item which can be selected in a menu.") public class JMenuItem extends AbstractButton implements Accessible, MenuElement

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

Элементы меню можно настраивать и, в определённой степени, контролировать с помощью Action. Использование Action с элементом меню имеет много преимуществ по сравнению с непосредственной настройкой элемента меню. Подробнее см. Компоненты Swing, поддерживающие Action, а также Как использовать действия в Руководстве Java.

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

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

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

Since:

1.2

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`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

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

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

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

Краткое описание конструкторов

Конструктор	Описание
`JMenuItem()`	Создает `JMenuItem` без заданного текста или иконки.
`JMenuItem(String text)`	Создает `JMenuItem` со заданным текстом.
`JMenuItem(String text, int mnemonic)`	Создаёт `JMenuItem` со заданным текстом и горячей клавишей.
`JMenuItem(String text, Icon icon)`	Создаёт `JMenuItem` со заданным текстом и иконкой.
`JMenuItem(Action a)`	Создаёт элемент меню, свойства которого взяты из указанного `Action`.
`JMenuItem(Icon icon)`	Создаёт `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)`	Устанавливает объект look and feel, который отрисовывает этот компонент.
`void`	`updateUI()`	Сбрасывает свойство UI со значением из текущего look and feel.

Методы, объявленные в классе 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, 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, 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

См. также:

init

protected void init(String text, Icon icon)

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

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

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the LookAndFeel.") public void setUI(MenuItemUI ui)

Устанавливает объект стиля отображения, который отрисовывает этот компонент.

Параметры:

ui - объект стиля отображения L&F

См. также:

updateUI

public void updateUI()

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

Переопределяет:

updateUI в классе AbstractButton

См. также:

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

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

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "MenuItemUI"

См. также:

setArmed

@BeanProperty(bound=false, hidden=true, description="Mouse release will fire an action event") public void setArmed(boolean b)

Идентифицирует элемент меню как "активированный". Если кнопка мыши отпускается, когда она находится над этим элементом, событие действия меню будет активировано. Если кнопка мыши отпускается в другом месте, событие не будет активировано, и элемент меню будет деактивирован.

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

isArmed

public boolean isArmed()

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

Возвращает:

true, если элемент меню активирован, и его можно выбрать

См. также:

setEnabled

@BeanProperty(preferred=true, description="The enabled state of the component.") public void setEnabled(boolean b)

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

Переопределяет:

setEnabled в классе AbstractButton

Параметры:

b - true для включения элемента

См. также:

setAccelerator

@BeanProperty(preferred=true, description="The keystroke combination which will invoke the JMenuItem\'s actionlisteners without navigating the menu hierarchy") 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

См. также:

actionPropertyChanged

protected void actionPropertyChanged(Action action, String propertyName)

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

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

Переопределяет:

actionPropertyChanged в классе AbstractButton

Параметры:

action - Action связанное с этой кнопкой

propertyName - имя свойства, которое изменилось

С тех пор:

1.6

См. также:

processMouseEvent

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

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

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

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

processKeyEvent

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

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

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

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

processMenuDragMouseEvent

public void processMenuDragMouseEvent(MenuDragMouseEvent e)

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

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

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

public void processMenuKeyEvent(MenuKeyEvent e)

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

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