Класс 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; дополнительную информацию можно найти в разделе Использование действий руководства The Java Tutorial.

Дополнительную документацию и примеры см. в разделе Использование меню руководства The Java Tutorial.

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

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

Начиная с версии:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JMenuItem.AccessibleJMenuItem`	Этот класс реализует поддержку специальных возможностей для класса `JMenuItem`.

Вложенные классы/интерфейсы, объявленные в классе AbstractButton

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

Вложенные классы/интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе Component

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

Краткое описание полей

Поля, объявленные в классе 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

Поля, объявленные в классе JComponent

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

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе 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)`	Задаёт объект оформления, который отрисовывает этот компонент.
`void`	`updateUI()`	Сбрасывает свойство UI, присваивая ему значение из текущего оформления.

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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 — объект оформления и стиля JMenuItemUI

См. также:

updateUI

public void updateUI()

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

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

updateUI в классе AbstractButton

См. также:

getUIClassID

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

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

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

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)

Задает сочетание клавиш, вызывающее прослушиватели действий пункта меню без перемещения по иерархии меню. За установку правильного действия отвечает пользовательский интерфейс. Обратите внимание: сочетание клавиш сработает независимо от того, отображается ли в данный момент меню.

Параметры:: 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 — 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