Класс 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.

С момента:

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` с указанным изображением.

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

Modifier and Type	Method	Description
`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 со значением из текущего визуального оформления.

Methods declared in class 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

Methods declared in class 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

Methods declared in class 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

Methods declared in class 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

Methods declared in class 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 JMenuItemUI

См. также:

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 - событие MouseEvent; path - массив путей MenuElement; manager - MenuSelectionManager

обработкаНажатияКлавиши

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

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

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

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

обработкаСобытияПеретаскиванияМышиВМеню

public void processMenuDragMouseEvent(MenuDragMouseEvent e)

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

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

обработкаСобытияНажатияКлавишиВМеню

public void processMenuKeyEvent(MenuKeyEvent e)

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

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