Класс PopupMenu

java.lang.Object

java.awt.MenuComponent

java.awt.MenuItem

java.awt.Menu

java.awt.PopupMenu

Все реализуемые интерфейсы:: MenuContainer, Serializable, Accessible

public class PopupMenu extends Menu

Класс, реализующий меню, которое можно динамически отображать в указанном месте компонента.

Как следует из иерархии наследования, PopupMenu можно использовать везде, где можно использовать Menu. Однако если использовать PopupMenu как Menu (например, добавить его в MenuBar), то нельзя вызывать show для этого PopupMenu.

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`PopupMenu.AccessibleAWTPopupMenu`	Внутренний класс PopupMenu, обеспечивающий поддержку специальных возможностей по умолчанию.

Menu.AccessibleAWTMenu

Модификатор и тип	Класс	Описание
`protected class`	`Menu.AccessibleAWTMenu`	Внутренний класс Menu, обеспечивающий поддержку специальных возможностей по умолчанию.

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

MenuItem.AccessibleAWTMenuItem

Модификатор и тип	Класс	Описание
`protected class`	`MenuItem.AccessibleAWTMenuItem`	Внутренний класс MenuItem, обеспечивающий поддержку специальных возможностей по умолчанию.

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

MenuComponent.AccessibleAWTMenuComponent

Модификатор и тип	Класс	Описание
`protected class`	`MenuComponent.AccessibleAWTMenuComponent`	Внутренний класс `MenuComponent`, обеспечивающий поддержку специальных возможностей по умолчанию.

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

Конструктор	Описание
`PopupMenu()`	Создает новое всплывающее меню с пустым именем.
`PopupMenu(String label)`	Создает новое всплывающее меню с указанным именем.

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

Модификатор и тип	Метод	Описание
`void`	`addNotify()`	Создает peer-объект всплывающего меню.
`AccessibleContext`	`getAccessibleContext()`	Возвращает `AccessibleContext`, связанный с этим `PopupMenu`.
`void`	`show(Component origin, int x, int y)`	Отображает всплывающее меню в точке с координатами x, y относительно исходного компонента.

add, add, addSeparator, countItems, getItem, getItemCount, insert, insert, insertSeparator, isTearOff, paramString, remove, remove, removeAll, removeNotify

Модификатор и тип	Метод	Описание
`MenuItem`	`add(MenuItem mi)`	Добавляет указанный пункт меню в это меню.
`void`	`add(String label)`	Добавляет в это меню пункт с указанной меткой.
`void`	`addSeparator()`	Добавляет в меню разделительную линию или дефис в текущую позицию.
`int`	`countItems()`	Устарело. Начиная с JDK версии 1.1 заменено на `getItemCount()`.
`MenuItem`	`getItem(int index)`	Возвращает пункт меню, расположенный по указанному индексу в этом меню.
`int`	`getItemCount()`	Возвращает количество пунктов в этом меню.
`void`	`insert(MenuItem menuitem, int index)`	Вставляет пункт меню в это меню в указанную позицию.
`void`	`insert(String label, int index)`	Вставляет пункт с указанной меткой в это меню в указанную позицию.
`void`	`insertSeparator(int index)`	Вставляет разделитель в указанную позицию.
`boolean`	`isTearOff()`	Указывает, является ли это меню отрывным.
`String`	`paramString()`	Возвращает строку, представляющую состояние этого `Menu`.
`void`	`remove(int index)`	Удаляет из этого меню пункт, расположенный по указанному индексу.
`void`	`remove(MenuComponent item)`	Удаляет указанный пункт из этого меню.
`void`	`removeAll()`	Удаляет все пункты из этого меню.
`void`	`removeNotify()`	Удаляет peer-объект меню.

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

addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getListeners, getShortcut, isEnabled, processActionEvent, processEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut

Модификатор и тип	Метод	Описание
`void`	`addActionListener(ActionListener l)`	Добавляет указанный прослушиватель действий для получения событий действий от этого пункта меню.
`void`	`deleteShortcut()`	Удаляет любой объект `MenuShortcut`, связанный с этим пунктом меню.
`void`	`disable()`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Отключает доставку событий этому пункту меню для событий, заданных указанной маской событий.
`void`	`enable()`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с JDK версии 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Включает доставку этому пункту меню событий, заданных указанной маской событий.
`String`	`getActionCommand()`	Возвращает имя команды события действия, генерируемого этим пунктом меню.
`ActionListener[]`	`getActionListeners()`	Возвращает массив всех прослушивателей действий, зарегистрированных для этого пункта меню.
`String`	`getLabel()`	Возвращает метку этого пункта меню.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в данный момент как `FooListener` для этого `MenuItem`.
`MenuShortcut`	`getShortcut()`	Возвращает объект `MenuShortcut`, связанный с этим пунктом меню,
`boolean`	`isEnabled()`	Проверяет, включен ли этот пункт меню.
`protected void`	`processActionEvent(ActionEvent e)`	Обрабатывает события действий, возникающие для этого пункта меню, отправляя их зарегистрированным объектам `ActionListener`.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события этого пункта меню.
`void`	`removeActionListener(ActionListener l)`	Удаляет указанный прослушиватель действий, чтобы он больше не получал события действий от этого пункта меню.
`void`	`setActionCommand(String command)`	Задает имя команды события действия, генерируемого этим пунктом меню.
`void`	`setEnabled(boolean b)`	Задает, можно ли выбрать этот пункт меню.
`void`	`setLabel(String label)`	Задает для этого пункта меню указанную метку.
`void`	`setShortcut(MenuShortcut s)`	Задает объект `MenuShortcut`, связанный с этим пунктом меню.

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

dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, setFont, setName, toString

Модификатор и тип	Метод	Описание
`final void`	`dispatchEvent(AWTEvent e)`	Передает событие этому компоненту или одному из его подкомпонентов.
`Font`	`getFont()`	Возвращает шрифт, используемый для этого компонента меню.
`String`	`getName()`	Возвращает имя компонента меню.
`MenuContainer`	`getParent()`	Возвращает родительский контейнер этого компонента меню.
`protected final Object`	`getTreeLock()`	Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов AWT и компоновкой.
`boolean`	`postEvent(Event evt)`	Устарело. Начиная с JDK версии 1.1 заменено на `dispatchEvent`.
`void`	`setFont(Font f)`	Задает указанный шрифт для этого компонента меню.
`void`	`setName(String name)`	Задает указанную строку в качестве имени компонента.
`String`	`toString()`	Возвращает строковое представление этого компонента меню.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

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

getFont, postEvent

Модификатор и тип	Метод	Описание
`Font`	`getFont()`	Возвращает шрифт, используемый этим контейнером.
`boolean`	`postEvent(Event evt)`	Устарело. Начиная с JDK версии 1.1 заменено на dispatchEvent(AWTEvent).

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

PopupMenu

public PopupMenu() throws HeadlessException

Создает новое всплывающее меню с пустым именем.

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

PopupMenu

public PopupMenu(String label) throws HeadlessException

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

Параметры:

label — строка, не равная null, задающая метку всплывающего меню

Выбрасывает:

HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.

См. также:

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

addNotify

public void addNotify()

Создает peer-объект всплывающего меню. Peer-объект позволяет изменить внешний вид всплывающего меню, не меняя его функциональность.

Переопределяет:: addNotify в классе Menu

show

public void show(Component origin, int x, int y)

Отображает всплывающее меню в точке с координатами x, y относительно исходного компонента. Исходный компонент должен находиться в иерархии компонентов родительского компонента всплывающего меню. Чтобы этот метод работал корректно, и исходный, и родительский компоненты должны отображаться на экране.

Если этот PopupMenu используется как Menu (то есть у него есть родитель, отличный от Component), этот метод нельзя вызывать для PopupMenu.

Параметры:: origin — компонент, задающий систему координат; x — координата x для отображения меню; y — координата y для отображения меню
Выбрасывает:: NullPointerException — если родительский компонент является null; IllegalArgumentException — если у этого PopupMenu есть родитель, отличный от Component; IllegalArgumentException — если исходный компонент не входит в иерархию родительского компонента; RuntimeException — если родительский компонент не отображается на экране

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим PopupMenu.

Определен в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Menu
Возвращает:: AccessibleContext этого PopupMenu
Начиная с:: 1.3

© 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.