Класс Меню

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

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

Функциональность выпадающего меню может не поддерживаться всеми реализациями AWT. Если конкретная реализация не поддерживает выпадающие меню, это значение игнорируется.

Параметры:

label - метка меню в строке меню или в другом меню, в котором это меню является подменю.

tearOff - если true, меню является выпадающим.

Исключение:

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

См. также:

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

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, 2023, 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/21/docs/api/java.desktop/java/awt/Menu.html