Класс 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

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

MenuComponent.AccessibleAWTMenuComponent

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

Конструктор	Описание
`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

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

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

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

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

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

getFont, postEvent

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Menu.html