Класс JMenu

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 элементов, меню также может содержать JSeparator разделители.

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

Настройку и, в некоторой степени, управление менюми осуществляют Action. Использование Action с меню предоставляет множество преимуществ по сравнению с непосредственной настройкой меню. Дополнительную информацию смотрите в Раздел "Компоненты Swing, поддерживающие Action, и в Руководстве по использованию действий в Java Tutorial.

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

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

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

С:

1.2

См. также:

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

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

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

JMenuItem.AccessibleJMenuItem

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

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

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

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

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

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

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

Modifier and Type	Method	Description
`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()`	Возвращает имя класса L&F, который отрисовывает этот компонент.
`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()`	Сбрасывает свойство пользовательского интерфейса со значением из текущей темы оформления.

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

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

Методы, объявленные в классе 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, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Методы, объявленные в классе java.awt.Container

add, add, add, 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

Методы, объявленные в классе 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, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе javax.swing.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"

См. также:

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 - значение boolean — 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)

Устанавливает рекомендуемую задержку до всплытия или закрытия всплывающего меню компонента. Каждый стиль (L&F) может определить свою политику наблюдения за свойством задержки. В большинстве случаев задержка не учитывается для меню верхнего уровня или при перетаскивании. Этот метод относится к коду визуального оформления и используется для управления особенностями различных UI-реализаций.

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

См. также:

add

public Component add(Component c, int index)

Добавляет указанный компонент в этот контейнер в заданной позиции. Если index равно -1, компонент будет добавлен в конец.

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

add в классе Container

Параметры:

c - добавляемый Component

index - позиция для вставки компонента

Возвращает:

добавленный Component

См. также:

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.

Parameters:: b - элемент меню, для которого нужно создать PropertyChangeListener
Returns:: PropertyChangeListener для b

addSeparator

public void addSeparator()

Добавляет новую разделительную черту в конец меню.

insert

public void insert(String s, int pos)

Вставляет новый пункт меню с указанным текстом в заданную позицию.

Parameters:: s - текст для добавляемого пункта меню; pos - целое число, определяющее позицию для добавления нового пункта меню
Throws:: IllegalArgumentException - если значение pos < 0

insert

public JMenuItem insert(JMenuItem mi, int pos)

Вставляет указанный JMenuitem в заданную позицию.

Parameters:: mi - добавляемый JMenuitem; pos - целое число, определяющее позицию для добавления нового JMenuitem
Returns:: новый пункт меню
Throws:: IllegalArgumentException - если значение pos < 0

insert

public JMenuItem insert(Action a, int pos)

Вставляет новый пункт меню, связанный с указанным объектом Action в заданную позицию.

Parameters:: a - объект Action для добавляемого пункта меню; pos - целое число, определяющее позицию для добавления нового пункта меню
Returns:: новый пункт меню
Throws:: IllegalArgumentException - если значение pos < 0

insertSeparator

public void insertSeparator(int index)

Вставляет разделитель в указанную позицию.

Parameters:: index - целое число, определяющее позицию вставки разделителя меню
Throws:: IllegalArgumentException - если значение index < 0

getItem

public JMenuItem getItem(int pos)

Возвращает JMenuItem в указанной позиции. Если компонент в pos не является пунктом меню, возвращается null. Этот метод включен для совместимости с AWT.

Parameters:: pos - целое число, определяющее позицию
Returns:: пункт меню в указанной позиции; или null, если элемент в указанной позиции не является пунктом меню
Throws:: IllegalArgumentException - если значение pos < 0

getItemCount

@BeanProperty(bound=false) public int getItemCount()

Возвращает количество элементов в меню, включая разделители. Этот метод включен для совместимости с AWT.

Returns:

целое число, равное количеству элементов в меню

See Also:

getMenuComponentCount()

isTearOff

@BeanProperty(bound=false) public boolean isTearOff()

Возвращает true, если меню можно отделить. Этот метод еще не реализован.

Returns:: true, если меню можно отделить, иначе false
Throws:: Error - если вызов -- этот метод еще не реализован

remove

public void remove(JMenuItem item)

Удаляет указанный пункт меню из этого меню. Если всплывающего меню нет, этот метод не окажет никакого влияния.

Parameters:: item - JMenuItem для удаления из меню

remove

public void remove(int pos)

Удаляет пункт меню в указанном индексе из этого меню.

Overrides:

remove в классе Container

Parameters:

pos - позиция удаляемого элемента

Throws:

IllegalArgumentException - если значение pos < 0, или если pos больше, чем количество пунктов меню

See Also:

remove

public void remove(Component c)

Удаляет компонент c из этого меню.

Overrides:

remove в классе Container

Parameters:

c - удаляемый компонент

See Also:

removeAll

public void removeAll()

Удаляет все пункты меню из этого меню.

Overrides:

removeAll в классе Container

See Also:

getMenuComponentCount

@BeanProperty(bound=false) public int getMenuComponentCount()

Возвращает количество компонентов в меню.

Returns:: целое число, содержащее количество компонентов в меню

getMenuComponent

public Component getMenuComponent(int n)

Возвращает компонент в позиции n.

Parameters:: n - позиция возвращаемого компонента
Returns:: запрашиваемый компонент, или null, если нет всплывающего меню

getMenuComponents

@BeanProperty(bound=false) public Component[] getMenuComponents()

Возвращает массив Component подкомпонентов меню. Обратите внимание, что это возвращает все Component в всплывающем меню, включая разделители.

Returns:: массив Component или пустой массив, если нет всплывающего меню

isTopLevelMenu

@BeanProperty(bound=false) public boolean isTopLevelMenu()

Возвращает true, если меню является 'главным меню', то есть если оно является прямым потомком меню-строки.

Returns:: true, если меню активировано из меню-строки; false, если меню активировано из пункта меню другого меню

isMenuComponent

public boolean isMenuComponent(Component c)

Возвращает true, если указанный компонент существует в иерархии подменю.

Parameters:: c - тестируемый Component
Returns:: true, если Component существует, false в противном случае

getPopupMenu

@BeanProperty(bound=false) public JPopupMenu getPopupMenu()

Возвращает всплывающее меню, связанное с этим меню. Если всплывающего меню нет, оно создаст его.

Returns:: связанное со всем меню JPopupMenu

addMenuListener

public void addMenuListener(MenuListener l)

Добавляет слушателя событий меню.

Parameters:: l - добавляемый слушатель

removeMenuListener

public void removeMenuListener(MenuListener l)

Удаляет слушателя событий меню.

Parameters:: l - удаляемый слушатель

getMenuListeners

@BeanProperty(bound=false) public MenuListener[] getMenuListeners()

Возвращает массив всех MenuListener добавленных к этому JMenu с помощью addMenuListener().

Returns:: все добавленные MenuListener или пустой массив, если слушатели не добавлены
Since:: 1.4

fireMenuSelected

protected void fireMenuSelected()

Уведомляет всех слушателей, которые зарегистрировали интерес к уведомлению об этом типе события. Экземпляр события создается лениво.

Throws:

Error - если есть слушатель null

See Also:

EventListenerList

fireMenuDeselected

protected void fireMenuDeselected()

Уведомляет всех слушателей, которые проявили интерес к уведомлению об этом типе события. Экземпляр события создается лениво.

Throws:

Error - если есть слушатель null

See Also:

EventListenerList

fireMenuCanceled

protected void fireMenuCanceled()

Throws:

Error - если есть слушатель null

See Also:

EventListenerList

createWinListener

protected JMenu.WinListener createWinListener(JPopupMenu p)

Создает слушатель закрытия окна для всплывающего меню.

Parameters:

p - всплывающее меню

Returns:

новый слушатель закрытия окна

See Also:

JMenu.WinListener

menuSelectionChanged

public void menuSelectionChanged(boolean isIncluded)

Получает сообщение, когда выбор в строке меню изменяется для активации или деактивации этого меню. Переопределяет JMenuItem.menuSelectionChanged.

Specified by:

menuSelectionChanged в интерфейсе MenuElement

Overrides:

menuSelectionChanged в классе JMenuItem

Parameters:

isIncluded - true, если это меню активно; false, если нет

See Also:

MenuSelectionManager.setSelectedPath(MenuElement[])

getSubElements

@BeanProperty(bound=false) public MenuElement[] getSubElements()

Возвращает массив MenuElement, содержащий подменю для этого компонента меню. Если это всплывающее меню, возвращает пустой массив. Этот метод необходим для соответствия интерфейсу MenuElement. Обратите внимание, что, поскольку JSeparator не соответствуют интерфейсу MenuElement, этот массив будет содержать только JMenuItem.

Specified by:: getSubElements в интерфейсе MenuElement
Overrides:: getSubElements в классе JMenuItem
Returns:: массив объектов MenuElement

getComponent

public Component getComponent()

Возвращает java.awt.Component, используемый для отрисовки этого MenuElement. Возвращаемый компонент используется для преобразования событий и определения, находится ли событие внутри компонента меню.

Specified by:: getComponent в интерфейсе MenuElement
Overrides:: getComponent в классе JMenuItem
Returns:: Component для отрисовки этого элемента меню

applyComponentOrientation

public void applyComponentOrientation(ComponentOrientation o)

Устанавливает свойство ComponentOrientation этого меню и всех компонентов внутри него. Включает все компоненты, возвращаемые getMenuComponents.

Overrides:

applyComponentOrientation в классе Container

Parameters:

o - новая ориентация компонента этого меню и компонентов, содержащихся в нем.

Throws:

NullPointerException - если orientation равно null.

Since:

1.4

See Also:

setComponentOrientation

public void setComponentOrientation(ComponentOrientation o)

Устанавливает ориентацию для этого меню и связанного с ним всплывающего меню, определяемого аргументом ComponentOrientation.

Overrides:

setComponentOrientation в классе Component

Parameters:

o - новая ориентация для этого меню и связанного с ним всплывающего меню.

See Also:

setAccelerator

public void setAccelerator(KeyStroke keyStroke)

setAccelerator не определено для JMenu. Используйте setMnemonic вместо этого.

Overrides:: setAccelerator в классе JMenuItem
Parameters:: keyStroke - сочетание клавиш, которое вызовет обработчики действий JMenuItem без навигации по иерархии меню
Throws:: Error - если вызов -- этот метод не определен для JMenu. Используйте setMnemonic вместо этого

processKeyEvent

protected void processKeyEvent(KeyEvent evt)

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

Overrides:

processKeyEvent в классе JComponent

Parameters:

evt - событие нажатия клавиши для обработки

See Also:

doClick

public void doClick(int pressTime)

Программно выполняет "нажатие". Это переопределяет метод AbstractButton.doClick для отображения всплывающего меню.

Overrides:: doClick в классе AbstractButton
Parameters:: pressTime - указывает количество миллисекунд, в течение которого была нажата кнопка

paramString

protected String paramString()

Возвращает строковое представление этого JMenu. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут отличаться между реализациями. Возвращаемая строка может быть пустой, но не null.

Overrides:: paramString в классе JMenuItem
Returns:: строковое представление JMenu.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JMenu. Для JMenu AccessibleContext имеет вид AccessibleJMenu. Новый экземпляр AccessibleJMenu создается при необходимости.

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе JMenuItem
Returns:: AccessibleJMenu, служащий AccessibleContext для этого JMenu

© 1993, 2021, 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/17/docs/api/java.desktop/javax/swing/JMenu.html