Класс Меню

java.awt.Menu

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

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

public class Menu extends MenuItem implements MenuContainer, Accessible

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

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

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

С тех пор:

1.0

См. также:

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

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

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

MenuItem.AccessibleAWTMenuItem

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

MenuComponent.AccessibleAWTMenuComponent

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

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

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

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

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

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

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

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

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

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

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

getFont, postEvent

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

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

addNotify

public void addNotify()

Создаёт виджет меню. Виджет позволяет изменять внешний вид меню без изменения его функциональности.

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

removeNotify

public void removeNotify()

Удаляет виджет меню. Виджет позволяет изменять внешний вид меню без изменения его функциональности.

Переопределяет:: 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, связанный с этим меню. Для меню AccessibleContext принимает форму AccessibleAWTMenu. Новый экземпляр AccessibleAWTMenu создается при необходимости.

Задано в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе MenuItem
Возвращает:: AccessibleAWTMenu, который служит AccessibleContext этого меню
С тех пор:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Menu.html