Класс Menu

java.awt.Menu

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

Прямые известные подклассы:: PopupMenu

public class Menu extends MenuItem implements MenuContainer, Accessible

Объект Menu представляет собой компонент раскрывающегося меню, размещаемый в строке меню.

Меню может быть отрывным. Отрывное меню можно открыть и перетащить за пределы родительской строки меню или меню. Оно остается на экране после отпускания кнопки мыши. Механизм отрыва меню зависит от платформы, поскольку внешний вид отрывного меню определяется его peer-объектом. На платформах, не поддерживающих отрывные меню, свойство отрыва игнорируется.

Каждый элемент меню должен принадлежать классу MenuItem. Это может быть экземпляр MenuItem, подменю (экземпляр Menu) или флажок (экземпляр CheckboxMenuItem).

С версии:

1.0

См. также:

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

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

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

MenuItem.AccessibleAWTMenuItem

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

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

MenuComponent.AccessibleAWTMenuComponent

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

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

Конструктор	Описание
`Menu()`	Создает новое меню с пустой меткой.
`Menu(String label)`	Создает новое меню с указанной меткой.
`Menu(String label, boolean tearOff)`	Создает новое меню с указанной меткой и указывает, можно ли его оторвать.

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

Модификатор и тип	Метод	Описание
`MenuItem`	`add(MenuItem mi)`	Добавляет указанный элемент меню в это меню.
`void`	`add(String label)`	Добавляет в это меню элемент с указанной меткой.
`void`	`addNotify()`	Создает peer-объект меню.
`void`	`addSeparator()`	Добавляет в меню в текущей позиции разделительную линию.
`int`	`countItems()`	Устарел. Начиная с JDK версии 1.1 заменен на `getItemCount()`.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим Menu.
`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).

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

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

addNotify

public void addNotify()

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

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

removeNotify

public void removeNotify()

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

Переопределяет:: removeNotify в классе MenuComponent

isTearOff

public boolean isTearOff()

Указывает, является ли это меню отрывным.

Возвращает:: true, если меню является отрывным; в противном случае — false.

getItemCount

public int getItemCount()

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

Возвращает:: количество элементов в этом меню
С версии:: 1.1

countItems

@Deprecated public int countItems()

Устарел.

Начиная с JDK версии 1.1 заменен на getItemCount().

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

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

getItem

public MenuItem getItem(int index)

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

Параметры:: index — позиция возвращаемого элемента.
Возвращает:: элемент, расположенный по указанному индексу.

add

public MenuItem add(MenuItem mi)

Добавляет указанный элемент меню в это меню. Если элемент меню уже был частью другого меню, он удаляется из него.

Параметры:

mi — добавляемый элемент меню

Возвращает:

добавленный элемент меню

См. также:

add

public void add(String label)

Добавляет в это меню элемент с указанной меткой.

Параметры:

label — текст элемента

См. также:

insert

public void insert(MenuItem menuitem, int index)

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

Параметры:

menuitem — вставляемый элемент меню.

index — позиция, в которую следует вставить элемент меню.

Вызывает исключение:

IllegalArgumentException — если значение index меньше нуля

С версии:

1.1

См. также:

insert

public void insert(String label, int index)

Вставляет элемент меню с указанной меткой в это меню в указанную позицию. Это вспомогательный метод для insert(menuItem, index).

Параметры:

label — текст элемента

index — позиция, в которую следует вставить элемент меню

Вызывает исключение:

IllegalArgumentException — если значение index меньше нуля

С версии:

1.1

См. также:

addSeparator

public void addSeparator()

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

См. также:

insertSeparator

public void insertSeparator(int index)

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

Параметры:

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

Вызывает исключение:

IllegalArgumentException — если значение index меньше 0.

С версии:

1.1

См. также:

remove

public void remove(int index)

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

Параметры:: index — позиция удаляемого элемента.

remove

public void remove(MenuComponent item)

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

Определен в:: remove в интерфейсе MenuContainer
Параметры:: item — элемент, удаляемый из меню. Если item равен null или отсутствует в этом меню, метод ничего не делает.

removeAll

public void removeAll()

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

С версии:: 1.1

paramString

public String paramString()

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

Переопределяет:: paramString в классе MenuItem
Возвращает:: строку параметров этого меню

getAccessibleContext

public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим Menu. Для меню AccessibleContext представлен объектом AccessibleAWTMenu. При необходимости создается новый экземпляр AccessibleAWTMenu.

Определен в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе MenuItem
Возвращает:: AccessibleAWTMenu, который служит AccessibleContext этого Menu
С версии:: 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.