Класс 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
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
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 |
Создаёт новый JMenu, используя переданную строку в качестве текста. |
JMenu |
Создаёт новый JMenu, используя переданную строку в качестве текста и указывая, будет ли меню отсоединяемым. |
JMenu |
Создаёт меню, свойства которого задаются переданным Action. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Component |
add |
Добавляет компонент в конец этого меню. |
Component |
add |
Добавляет указанный компонент в этот контейнер в заданную позицию. |
JMenuItem |
add |
Создаёт элемент меню с указанным текстом и добавляет его в конец этого меню. |
JMenuItem |
add |
Создаёт элемент меню, связанный с указанным объектом Action, и добавляет его в конец этого меню. |
JMenuItem |
add |
Добавляет элемент меню в конец этого меню. |
void |
addMenuListener |
Добавляет слушатель событий меню. |
void |
addSeparator() |
Добавляет новый разделитель в конец меню. |
void |
applyComponentOrientation |
Задаёт свойство ComponentOrientation этого меню и всех содержащихся в нём компонентов. |
protected PropertyChangeListener |
createActionChangeListener |
Возвращает правильно настроенный PropertyChangeListener, который обновляет элемент управления при изменении Action. |
protected JMenuItem |
createActionComponent |
Фабричный метод, создающий JMenuItem для Action, добавленных в JMenu. |
protected JMenu.WinListener |
createWinListener |
Создаёт слушатель закрытия окна для всплывающего меню. |
void |
doClick |
Программно выполняет «щелчок». |
protected void |
fireMenuCanceled() |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
protected void |
fireMenuDeselected() |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
protected void |
fireMenuSelected() |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
AccessibleContext |
getAccessibleContext() |
Возвращает AccessibleContext, связанный с этим JMenu. |
Component |
getComponent() |
Возвращает java.awt.Component, используемый для отрисовки этого MenuElement. |
int |
getDelay() |
Возвращает рекомендуемую задержку в миллисекундах перед открытием или закрытием подменю. |
JMenuItem |
getItem |
Возвращает JMenuItem в указанной позиции. |
int |
getItemCount() |
Возвращает количество элементов меню, включая разделители. |
Component |
getMenuComponent |
Возвращает компонент в позиции n. |
int |
getMenuComponentCount() |
Возвращает количество компонентов в меню. |
Component[] |
getMenuComponents() |
Возвращает массив Component компонентов меню. |
MenuListener[] |
getMenuListeners() |
Возвращает массив всех MenuListener, добавленных в этот JMenu с помощью addMenuListener(). |
JPopupMenu |
getPopupMenu() |
Возвращает всплывающее меню, связанное с этим меню. |
protected Point |
getPopupMenuOrigin() |
Вычисляет начало координат для всплывающего меню JMenu. |
MenuElement[] |
getSubElements() |
Возвращает массив MenuElement, содержащих подменю для этого компонента меню. |
String |
getUIClassID() |
Возвращает имя класса оформления, отображающего этот компонент. |
void |
insert |
Вставляет новый элемент меню с указанным текстом в заданную позицию. |
JMenuItem |
insert |
Вставляет в заданную позицию новый элемент меню, связанный с указанным объектом Action. |
JMenuItem |
insert |
Вставляет указанный JMenuitem в заданную позицию. |
void |
insertSeparator |
Вставляет разделитель в указанную позицию. |
boolean |
isMenuComponent |
Возвращает true, если указанный компонент существует в иерархии подменю. |
boolean |
isPopupMenuVisible() |
Возвращает true, если всплывающее окно меню отображается. |
boolean |
isSelected() |
Возвращает true, если меню выбрано в данный момент (выделено). |
boolean |
isTearOff() |
Возвращает true, если меню можно отсоединить. |
boolean |
isTopLevelMenu() |
Возвращает true, если меню является меню верхнего уровня, то есть непосредственно вложено в строку меню. |
void |
menuSelectionChanged |
Вызывается при изменении выбора в строке меню для активации или деактивации этого меню. |
protected String |
paramString() |
Возвращает строковое представление этого JMenu. |
protected void |
processKeyEvent |
Обрабатывает события нажатия клавиш, например мнемоники и ускорители. |
void |
remove |
Удаляет из этого меню элемент меню с указанным индексом. |
void |
remove |
Удаляет из этого меню компонент c. |
void |
remove |
Удаляет указанный элемент меню из этого меню. |
void |
removeAll() |
Удаляет все элементы меню из этого меню. |
void |
removeMenuListener |
Удаляет слушатель событий меню. |
void |
setAccelerator |
setAccelerator не определён для JMenu. |
void |
setComponentOrientation |
Задаёт ориентацию этого меню и связанного с ним всплывающего меню в соответствии с аргументом ComponentOrientation. |
void |
setDelay |
Задаёт рекомендуемую задержку перед открытием или закрытием PopupMenu меню. |
void |
setMenuLocation |
Задаёт расположение всплывающего компонента. |
void |
setModel |
Задаёт модель данных для «кнопки меню» — метки, на которую пользователь нажимает, чтобы открыть или закрыть меню. |
void |
setPopupMenuVisible |
Задаёт видимость всплывающего меню. |
void |
setSelected |
Задаёт состояние выбора меню. |
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
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
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJMenuItem - Возвращает:
- строку "MenuUI"
- См. также:
setModel
public void setModel(ButtonModel newModel)
- Переопределяет:
-
setModelв классеAbstractButton - Параметры:
-
newModel—ButtonModel - См. также:
isSelected
public boolean isSelected()
- Переопределяет:
-
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, если меню видимо, иначе 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()
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
add
public Component add(Component c, int index)
index равно -1, компонент будет добавлен в конец.add
public JMenuItem add(String s)
- Параметры:
-
s— строка для добавляемого элемента меню - Возвращает:
- новый
JMenuItem
add
public JMenuItem add(Action a)
Action, и добавляет его в конец этого меню.- Параметры:
-
a—Actionдля добавляемого элемента меню - Возвращает:
- новый
JMenuItem - См. также:
createActionComponent
protected JMenuItem createActionComponent(Action a)
JMenuItem для Action, добавляемых в JMenu.- Параметры:
-
a—Actionдля добавляемого элемента меню - Возвращает:
- новый элемент меню
- Начиная с:
- 1.3
- См. также:
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()
- Возвращает:
- целое число, равное количеству элементов меню
- См. также:
isTearOff
@BeanProperty(bound=false) public boolean isTearOff()
- Возвращает:
- true, если меню можно отсоединить, иначе false
- Вызывает исключение:
-
Error— при вызове; этот метод пока не реализован
remove
public void remove(JMenuItem item)
- Параметры:
-
item—JMenuItem, удаляемый из меню
remove
public void remove(int pos)
- Переопределяет:
-
removeв классеContainer - Параметры:
-
pos— позиция удаляемого элемента - Вызывает исключение:
-
IllegalArgumentException— если значениеpos< 0 или еслиposпревышает количество элементов меню - См. также:
remove
removeAll
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, если меню активировано из строки меню; false, если меню активировано из элемента другого меню
isMenuComponent
public boolean isMenuComponent(Component c)
- Параметры:
-
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 - См. также:
fireMenuDeselected
protected void fireMenuDeselected()
- Вызывает исключение:
-
Error— если имеется слушательnull - См. также:
fireMenuCanceled
protected void fireMenuCanceled()
- Вызывает исключение:
-
Error— если имеется слушательnull - См. также:
createWinListener
protected JMenu.WinListener createWinListener(JPopupMenu p)
- Параметры:
-
p—JPopupMenu - Возвращает:
- новый слушатель закрытия окна
- См. также:
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
- См. также:
setComponentOrientation
public void setComponentOrientation(ComponentOrientation o)
ComponentOrientation.- Переопределяет:
-
setComponentOrientationв классеComponent - Параметры:
-
o— новая ориентация этого меню и связанного с ним всплывающего меню. - См. также:
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- событие клавиатуры, которое необходимо обработать - См. также:
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()
- Указано в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеJMenuItem - Возвращает:
- объект AccessibleJMenu, служащий AccessibleContext этого JMenu
© 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