Spec-Zone.ru › OpenJDK 25

Класс JMenu

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
javax.swing.JMenuItem
javax.swing.JMenu
Все реализованные интерфейсы:
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants
@JavaBean(description="A popup window containing menu items displayed in a menu bar.") public class JMenu extends JMenuItem implements Accessible, MenuElement
Реализация меню — всплывающего окна, содержащего JMenuItem, которое отображается, когда пользователь выбирает элемент в JMenuBar. Помимо JMenuItem, JMenu также может содержать JSeparator.

По сути, меню — это кнопка со связанным с ней JPopupMenu. Когда нажимают «кнопку», появляется JPopupMenu. Если «кнопка» расположена на JMenuBar, меню представляет собой окно верхнего уровня. Если «кнопка» является другим элементом меню, то JPopupMenu — это меню, раскрывающееся вправо.

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

Сведения и примеры использования меню см. в разделе Использование меню руководства Учебник по Java.

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

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

Начиная с версии:
1.2
См. также:
  • JMenuItem
  • JSeparator
  • JMenuBar
  • JPopupMenu

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

Модификатор и тип Класс Описание
protected class  JMenu.AccessibleJMenu
Этот класс реализует поддержку специальных возможностей для класса JMenu.
protected class  JMenu.WinListener
Класс-слушатель, отслеживающий закрытие всплывающего окна.

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

JMenuItem.AccessibleJMenuItem

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип Поле Описание
protected JMenu.WinListener popupListener
Слушатель закрытия окна для всплывающего меню.

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

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

Конструктор Описание
JMenu()
Создаёт новый JMenu без текста.
JMenu(String s)
Создаёт новый JMenu, используя переданную строку в качестве текста.
JMenu(String s, boolean b)
Создаёт новый JMenu, используя переданную строку в качестве текста и указывая, будет ли меню отсоединяемым.
JMenu(Action a)
Создаёт меню, свойства которого задаются переданным Action.

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

Модификатор и тип Метод Описание
Component add(Component c)
Добавляет компонент в конец этого меню.
Component add(Component c, int index)
Добавляет указанный компонент в этот контейнер в заданную позицию.
JMenuItem add(String s)
Создаёт элемент меню с указанным текстом и добавляет его в конец этого меню.
JMenuItem add(Action a)
Создаёт элемент меню, связанный с указанным объектом Action, и добавляет его в конец этого меню.
JMenuItem add(JMenuItem menuItem)
Добавляет элемент меню в конец этого меню.
void addMenuListener(MenuListener l)
Добавляет слушатель событий меню.
void addSeparator()
Добавляет новый разделитель в конец меню.
void applyComponentOrientation(ComponentOrientation o)
Задаёт свойство ComponentOrientation этого меню и всех содержащихся в нём компонентов.
protected PropertyChangeListener createActionChangeListener(JMenuItem b)
Возвращает правильно настроенный PropertyChangeListener, который обновляет элемент управления при изменении Action.
protected JMenuItem createActionComponent(Action a)
Фабричный метод, создающий JMenuItem для Action, добавленных в JMenu.
protected JMenu.WinListener createWinListener(JPopupMenu p)
Создаёт слушатель закрытия окна для всплывающего меню.
void doClick(int pressTime)
Программно выполняет «щелчок».
protected void fireMenuCanceled()
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
protected void fireMenuDeselected()
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
protected void fireMenuSelected()
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JMenu.
Component getComponent()
Возвращает java.awt.Component, используемый для отрисовки этого MenuElement.
int getDelay()
Возвращает рекомендуемую задержку в миллисекундах перед открытием или закрытием подменю.
JMenuItem getItem(int pos)
Возвращает JMenuItem в указанной позиции.
int getItemCount()
Возвращает количество элементов меню, включая разделители.
Component getMenuComponent(int n)
Возвращает компонент в позиции n.
int getMenuComponentCount()
Возвращает количество компонентов в меню.
Component[] getMenuComponents()
Возвращает массив Component компонентов меню.
MenuListener[] getMenuListeners()
Возвращает массив всех MenuListener, добавленных в этот JMenu с помощью addMenuListener().
JPopupMenu getPopupMenu()
Возвращает всплывающее меню, связанное с этим меню.
protected Point getPopupMenuOrigin()
Вычисляет начало координат для всплывающего меню JMenu.
MenuElement[] getSubElements()
Возвращает массив MenuElement, содержащих подменю для этого компонента меню.
String getUIClassID()
Возвращает имя класса оформления, отображающего этот компонент.
void insert(String s, int pos)
Вставляет новый элемент меню с указанным текстом в заданную позицию.
JMenuItem insert(Action a, int pos)
Вставляет в заданную позицию новый элемент меню, связанный с указанным объектом Action.
JMenuItem insert(JMenuItem mi, int pos)
Вставляет указанный JMenuitem в заданную позицию.
void insertSeparator(int index)
Вставляет разделитель в указанную позицию.
boolean isMenuComponent(Component c)
Возвращает true, если указанный компонент существует в иерархии подменю.
boolean isPopupMenuVisible()
Возвращает true, если всплывающее окно меню отображается.
boolean isSelected()
Возвращает true, если меню выбрано в данный момент (выделено).
boolean isTearOff()
Возвращает true, если меню можно отсоединить.
boolean isTopLevelMenu()
Возвращает true, если меню является меню верхнего уровня, то есть непосредственно вложено в строку меню.
void menuSelectionChanged(boolean isIncluded)
Вызывается при изменении выбора в строке меню для активации или деактивации этого меню.
protected String paramString()
Возвращает строковое представление этого JMenu.
protected void processKeyEvent(KeyEvent evt)
Обрабатывает события нажатия клавиш, например мнемоники и ускорители.
void remove(int pos)
Удаляет из этого меню элемент меню с указанным индексом.
void remove(Component c)
Удаляет из этого меню компонент c.
void remove(JMenuItem item)
Удаляет указанный элемент меню из этого меню.
void removeAll()
Удаляет все элементы меню из этого меню.
void removeMenuListener(MenuListener l)
Удаляет слушатель событий меню.
void setAccelerator(KeyStroke keyStroke)
setAccelerator не определён для JMenu.
void setComponentOrientation(ComponentOrientation o)
Задаёт ориентацию этого меню и связанного с ним всплывающего меню в соответствии с аргументом ComponentOrientation.
void setDelay(int d)
Задаёт рекомендуемую задержку перед открытием или закрытием PopupMenu меню.
void setMenuLocation(int x, int y)
Задаёт расположение всплывающего компонента.
void setModel(ButtonModel newModel)
Задаёт модель данных для «кнопки меню» — метки, на которую пользователь нажимает, чтобы открыть или закрыть меню.
void setPopupMenuVisible(boolean b)
Задаёт видимость всплывающего меню.
void setSelected(boolean b)
Задаёт состояние выбора меню.
void updateUI()
Сбрасывает свойство пользовательского интерфейса, используя значение текущего оформления.

Методы, объявленные в классе JMenuItem

actionPropertyChanged, addMenuDragMouseListener, addMenuKeyListener, configurePropertiesFromAction, fireMenuDragMouseDragged, fireMenuDragMouseEntered, fireMenuDragMouseExited, fireMenuDragMouseReleased, fireMenuKeyPressed, fireMenuKeyReleased, fireMenuKeyTyped, getAccelerator, getMenuDragMouseListeners, getMenuKeyListeners, init, isArmed, processKeyEvent, processMenuDragMouseEvent, processMenuKeyEvent, processMouseEvent, removeMenuDragMouseListener, removeMenuKeyListener, setArmed, setEnabled, setUI

Методы, объявленные в классе AbstractButton

addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, 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, 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, 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, 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, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, 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, 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, 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

Методы, объявленные в интерфейсе MenuElement

processKeyEvent, processMouseEvent

Подробное описание полей

popupListener

protected JMenu.WinListener popupListener
Слушатель закрытия окна всплывающего меню.
См. также:
  • JMenu.WinListener

Подробное описание конструкторов

JMenu

public JMenu()
Создает новый JMenu без текста.

JMenu

public JMenu(String s)
Создает новый JMenu с указанной строкой в качестве текста.
Параметры:
s — текст метки меню

JMenu

public JMenu(Action a)
Создает меню, свойства которого берутся из переданного объекта Action.
Параметры:
a — объект Action
Начиная с:
1.3

JMenu

public JMenu(String s, boolean b)
Создает новый JMenu с указанной строкой в качестве текста и с указанием, является ли меню отсоединяемым.
Параметры:
s — текст метки меню
b — можно ли отсоединить меню (пока не реализовано)

Подробное описание методов

updateUI

public void updateUI()
Сбрасывает свойство UI, используя значение из текущего оформления.
Переопределяет:
updateUI в классе JMenuItem
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса L&F, который отображает этот компонент.
Переопределяет:
getUIClassID в классе JMenuItem
Возвращает:
строку "MenuUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

setModel

public void setModel(ButtonModel newModel)
Задает модель данных для «кнопки меню» — метки, по которой пользователь щелкает, чтобы открыть или закрыть меню.
Переопределяет:
setModel в классе AbstractButton
Параметры:
newModel — ButtonModel
См. также:
  • AbstractButton.getModel()

isSelected

public boolean isSelected()
Возвращает true, если меню выбрано (подсвечено) в данный момент.
Переопределяет:
isSelected в классе AbstractButton
Возвращает:
true, если меню выбрано, иначе false

setSelected

@BeanProperty(expert=true, hidden=true, description="When the menu is selected, its popup child is shown.") public void setSelected(boolean b)
Задает состояние выбора меню.
Переопределяет:
setSelected в классе AbstractButton
Параметры:
b — true, чтобы выбрать (подсветить) меню; false, чтобы снять выбор

isPopupMenuVisible

public boolean isPopupMenuVisible()
Возвращает true, если всплывающее окно меню видимо.
Возвращает:
true, если меню видимо, иначе false

setPopupMenuVisible

@BeanProperty(bound=false, expert=true, hidden=true, description="The popup menu's visibility") public void setPopupMenuVisible(boolean b)
Задает видимость всплывающего меню. Если меню отключено, этот метод не оказывает никакого эффекта.
Параметры:
b — логическое значение: true, чтобы сделать меню видимым, false, чтобы скрыть его

getPopupMenuOrigin

protected Point getPopupMenuOrigin()
Вычисляет начало координат всплывающего меню JMenu. Этот метод использует свойства оформления с именами Menu.menuPopupOffsetX, Menu.menuPopupOffsetY, Menu.submenuPopupOffsetX и Menu.submenuPopupOffsetY для точной настройки расположения всплывающего меню.
Возвращает:
объект Point в системе координат меню, который следует использовать в качестве начала координат всплывающего меню JMenu
Начиная с:
1.3

getDelay

public int getDelay()
Возвращает рекомендуемую задержку в миллисекундах перед раскрытием или закрытием подменю. Каждое оформление (L&F) может определять собственную политику применения свойства delay. В большинстве случаев задержка не применяется к меню верхнего уровня и во время перетаскивания. Значение по умолчанию для delay — 0. Этот метод является свойством кода оформления и используется для управления особенностями различных реализаций пользовательского интерфейса.
Возвращает:
свойство delay

setDelay

@BeanProperty(bound=false, expert=true, description="The delay between menu selection and making the popup menu visible") public void setDelay(int d)
Задает рекомендуемую задержку перед раскрытием или закрытием PopupMenu меню. Каждое оформление (L&F) может определять собственную политику применения свойства задержки. В большинстве случаев задержка не применяется к меню верхнего уровня и во время перетаскивания. Этот метод является свойством кода оформления и используется для управления особенностями различных реализаций пользовательского интерфейса.
Параметры:
d — задержка в миллисекундах
Вызывает исключение:
IllegalArgumentException — если d меньше 0

setMenuLocation

public void setMenuLocation(int x, int y)
Задает расположение всплывающего компонента.
Параметры:
x — координата x нового положения всплывающего меню
y — координата y нового положения всплывающего меню

add

public JMenuItem add(JMenuItem menuItem)
Добавляет элемент меню в конец этого меню. Возвращает добавленный элемент меню.
Параметры:
menuItem — добавляемый JMenuitem
Возвращает:
добавленный JMenuItem

add

public Component add(Component c)
Добавляет компонент в конец этого меню. Возвращает добавленный компонент.
Переопределяет:
add в классе Container
Параметры:
c — добавляемый Component
Возвращает:
добавленный Component
См. также:
  • Container.addImpl(Component, Object, int)
  • Container.invalidate()
  • Container.validate()
  • JComponent.revalidate()

add

public Component add(Component c, int index)
Добавляет указанный компонент в этот контейнер в заданную позицию. Если index равно -1, компонент будет добавлен в конец.
Переопределяет:
add в классе Container
Параметры:
c — добавляемый Component
index — позиция, в которую следует вставить компонент
Возвращает:
добавленный Component
См. также:
  • remove(JMenuItem)
  • Container.add(Component, int)

add

public JMenuItem add(String s)
Создает новый элемент меню с указанным текстом и добавляет его в конец этого меню.
Параметры:
s — строка для добавляемого элемента меню
Возвращает:
новый JMenuItem

add

public JMenuItem add(Action a)
Создает новый элемент меню, связанный с указанным объектом Action, и добавляет его в конец этого меню.
Параметры:
a — Action для добавляемого элемента меню
Возвращает:
новый JMenuItem
См. также:
  • Action

createActionComponent

protected JMenuItem createActionComponent(Action a)
Фабричный метод, создающий JMenuItem для Action, добавляемых в JMenu.
Параметры:
a — Action для добавляемого элемента меню
Возвращает:
новый элемент меню
Начиная с:
1.3
См. также:
  • Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JMenuItem b)
Возвращает правильно настроенный PropertyChangeListener, который обновляет элемент управления при изменении Action.
Параметры:
b — элемент меню, для которого создается PropertyChangeListener
Возвращает:
PropertyChangeListener для b

addSeparator

public void addSeparator()
Добавляет новый разделитель в конец меню.

insert

public void insert(String s, int pos)
Вставляет новый элемент меню с указанным текстом в заданную позицию.
Параметры:
s — текст добавляемого элемента меню
pos — целое число, задающее позицию для добавления нового элемента меню
Вызывает исключение:
IllegalArgumentException — если значение pos < 0

insert

public JMenuItem insert(JMenuItem mi, int pos)
Вставляет указанный JMenuitem в заданную позицию.
Параметры:
mi — добавляемый JMenuitem
pos — целое число, задающее позицию для добавления нового JMenuitem
Возвращает:
новый элемент меню
Вызывает исключение:
IllegalArgumentException — если значение pos < 0

insert

public JMenuItem insert(Action a, int pos)
Вставляет новый элемент меню, связанный с указанным объектом Action, в заданную позицию.
Параметры:
a — объект Action для добавляемого элемента меню
pos — целое число, задающее позицию для добавления нового элемента меню
Возвращает:
новый элемент меню
Вызывает исключение:
IllegalArgumentException — если значение pos < 0

insertSeparator

public void insertSeparator(int index)
Вставляет разделитель в указанную позицию.
Параметры:
index — целое число, задающее позицию для вставки разделителя меню
Вызывает исключение:
IllegalArgumentException — если значение index < 0

getItem

public JMenuItem getItem(int pos)
Возвращает JMenuItem в указанной позиции. Если компонент в pos не является элементом меню, возвращается null. Этот метод включен для совместимости с AWT.
Параметры:
pos — целое число, задающее позицию
Возвращает:
элемент меню в указанной позиции; либо null, если элемент в указанной позиции не является элементом меню
Вызывает исключение:
IllegalArgumentException — если значение pos < 0

getItemCount

@BeanProperty(bound=false) public int getItemCount()
Возвращает количество элементов меню, включая разделители. Этот метод включен для совместимости с AWT.
Возвращает:
целое число, равное количеству элементов меню
См. также:
  • getMenuComponentCount()

isTearOff

@BeanProperty(bound=false) public boolean isTearOff()
Возвращает true, если меню можно отсоединить. Этот метод пока не реализован.
Возвращает:
true, если меню можно отсоединить, иначе false
Вызывает исключение:
Error — при вызове; этот метод пока не реализован

remove

public void remove(JMenuItem item)
Удаляет указанный элемент меню из этого меню. Если всплывающего меню нет, этот метод не оказывает никакого эффекта.
Параметры:
item — JMenuItem, удаляемый из меню

remove

public void remove(int pos)
Удаляет элемент меню с указанным индексом из этого меню.
Переопределяет:
remove в классе Container
Параметры:
pos — позиция удаляемого элемента
Вызывает исключение:
IllegalArgumentException — если значение pos < 0 или если pos превышает количество элементов меню
См. также:
  • Container.add(Component)
  • Container.invalidate()
  • Container.validate()
  • Container.getComponentCount()

remove

public void remove(Component c)
Удаляет компонент c из этого меню.
Переопределяет:
remove в классе Container
Параметры:
c — удаляемый компонент
См. также:
  • Container.add(Component)
  • Container.invalidate()
  • Container.validate()
  • Container.remove(int)

removeAll

public void removeAll()
Удаляет все элементы меню из этого меню.
Переопределяет:
removeAll в классе Container
См. также:
  • Container.add(Component)
  • Container.remove(int)
  • Container.invalidate()

getMenuComponentCount

@BeanProperty(bound=false) public int getMenuComponentCount()
Возвращает количество компонентов в меню.
Возвращает:
целое число, содержащее количество компонентов в меню

getMenuComponent

public Component getMenuComponent(int n)
Возвращает компонент в позиции n.
Параметры:
n — позиция возвращаемого компонента
Возвращает:
запрошенный компонент или null, если всплывающего меню нет

getMenuComponents

@BeanProperty(bound=false) public Component[] getMenuComponents()
Возвращает массив Component компонентов подменю. Обратите внимание: возвращаются все Component всплывающего меню, включая разделители.
Возвращает:
массив Component или пустой массив, если всплывающего меню нет

isTopLevelMenu

@BeanProperty(bound=false) public boolean isTopLevelMenu()
Возвращает true, если меню является «меню верхнего уровня», то есть непосредственным дочерним элементом строки меню.
Возвращает:
true, если меню активировано из строки меню; false, если меню активировано из элемента другого меню

isMenuComponent

public boolean isMenuComponent(Component c)
Возвращает true, если указанный компонент присутствует в иерархии подменю.
Параметры:
c — проверяемый Component
Возвращает:
true, если Component присутствует, иначе false

getPopupMenu

@BeanProperty(bound=false) public JPopupMenu getPopupMenu()
Возвращает всплывающее меню, связанное с этим меню. Если всплывающего меню нет, оно будет создано.
Возвращает:
JPopupMenu, связанное с этим меню

addMenuListener

public void addMenuListener(MenuListener l)
Добавляет слушатель событий меню.
Параметры:
l — добавляемый слушатель

removeMenuListener

public void removeMenuListener(MenuListener l)
Удаляет слушатель событий меню.
Параметры:
l — удаляемый слушатель

getMenuListeners

@BeanProperty(bound=false) public MenuListener[] getMenuListeners()
Возвращает массив всех MenuListener, добавленных в этот JMenu с помощью addMenuListener().
Возвращает:
все добавленные MenuListener или пустой массив, если слушатели не добавлялись
Начиная с:
1.4

fireMenuSelected

protected void fireMenuSelected()
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям об этом типе событий. Экземпляр события создается по требованию.
Вызывает исключение:
Error — если имеется слушатель null
См. также:
  • EventListenerList

fireMenuDeselected

protected void fireMenuDeselected()
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям об этом типе событий. Экземпляр события создается по требованию.
Вызывает исключение:
Error — если имеется слушатель null
См. также:
  • EventListenerList

fireMenuCanceled

protected void fireMenuCanceled()
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям об этом типе событий. Экземпляр события создается по требованию.
Вызывает исключение:
Error — если имеется слушатель null
См. также:
  • EventListenerList

createWinListener

protected JMenu.WinListener createWinListener(JPopupMenu p)
Создает слушатель закрытия окна всплывающего меню.
Параметры:
p — JPopupMenu
Возвращает:
новый слушатель закрытия окна
См. также:
  • JMenu.WinListener

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)
Вызывается, когда выбор в строке меню изменяется, чтобы активировать или деактивировать это меню. Переопределяет JMenuItem.menuSelectionChanged.
Определено в:
menuSelectionChanged в интерфейсе MenuElement
Переопределяет:
menuSelectionChanged в классе JMenuItem
Параметры:
isIncluded — true, если это меню активно, иначе false
См. также:
  • MenuSelectionManager.setSelectedPath(MenuElement[])

getSubElements

@BeanProperty(bound=false) public MenuElement[] getSubElements()
Возвращает массив MenuElement, содержащих подменю этого компонента меню. Если всплывающее меню равно null, возвращается пустой массив. Этот метод необходим для соответствия интерфейсу MenuElement. Обратите внимание: поскольку JSeparator не соответствуют интерфейсу MenuElement, этот массив будет содержать только JMenuItem.
Определено в:
getSubElements в интерфейсе MenuElement
Переопределяет:
getSubElements в классе JMenuItem
Возвращает:
массив объектов MenuElement

getComponent

public Component getComponent()
Возвращает java.awt.Component, используемый для отрисовки этого MenuElement. Возвращенный компонент используется для преобразования событий и определения того, находится ли событие внутри компонента меню.
Определено в:
getComponent в интерфейсе MenuElement
Переопределяет:
getComponent в классе JMenuItem
Возвращает:
Component, который отрисовывает этот элемент меню

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)
Задает свойство ComponentOrientation этого меню и всех содержащихся в нем компонентов. Сюда входят все компоненты, возвращаемые методом getMenuComponents.
Переопределяет:
applyComponentOrientation в классе Container
Параметры:
o — новая ориентация компонентов этого меню и содержащихся в нем компонентов.
Вызывает исключение:
NullPointerException — если orientation равно null.
Начиная с:
1.4
См. также:
  • Component.setComponentOrientation(ComponentOrientation)
  • Component.getComponentOrientation()

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)
Задает ориентацию этого меню и связанного с ним всплывающего меню на основе аргумента ComponentOrientation.
Переопределяет:
setComponentOrientation в классе Component
Параметры:
o — новая ориентация этого меню и связанного с ним всплывающего меню.
См. также:
  • ComponentOrientation
  • Component.invalidate()

setAccelerator

public void setAccelerator(KeyStroke keyStroke)
setAccelerator не определен для JMenu. Вместо него используйте setMnemonic.
Переопределяет:
setAccelerator в классе JMenuItem
Параметры:
keyStroke — комбинация клавиш, которая вызывает обработчики действий JMenuItem без перехода по иерархии меню
Вызывает исключение:
Error — при вызове; этот метод не определен для JMenu. Вместо него используйте setMnemonic

processKeyEvent

protected void processKeyEvent(KeyEvent evt)
Обрабатывает события нажатия клавиш, такие как мнемоники и клавиши быстрого доступа.
Переопределяет:
processKeyEvent в классе JComponent
Параметры:
evt - событие клавиатуры, которое необходимо обработать
См. также:
  • KeyEvent
  • KeyListener
  • KeyboardFocusManager
  • DefaultKeyboardFocusManager
  • Component.processEvent(AWTEvent)
  • Component.dispatchEvent(AWTEvent)
  • Component.addKeyListener(KeyListener)
  • Component.enableEvents(long)
  • Component.isShowing()

doClick

public void doClick(int pressTime)
Программно выполняет «щелчок». Этот метод переопределяет метод AbstractButton.doClick, чтобы отображать всплывающее меню.
Переопределяет:
doClick в классе AbstractButton
Параметры:
pressTime - указывает длительность нажатия кнопки в миллисекундах

paramString

protected String paramString()
Возвращает строковое представление этого JMenu. Этот метод предназначен только для отладки, а содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
paramString в классе JMenuItem
Возвращает:
строковое представление этого JMenu.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JMenu. Для JMenu объект AccessibleContext имеет вид AccessibleJMenu. При необходимости создается новый экземпляр AccessibleJMenu.
Указано в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе JMenuItem
Возвращает:
объект AccessibleJMenu, служащий AccessibleContext этого JMenu

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JMenu.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API