Класс Menu

Все реализованные интерфейсы:
MenuContainer, Serializable, Accessible
Прямые известные подклассы:
PopupMenu
public class Menu
extends MenuItem
implements MenuContainer, Accessible

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

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

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

С:
1.0
См. также:
MenuItem, CheckboxMenuItem, Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
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

Конструкторы

Меню

public Menu()
     throws HeadlessException

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

Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
С момента:
1.1
См. также:
GraphicsEnvironment.isHeadless()

Меню

public Menu(String label)
     throws HeadlessException

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

Параметры:
label - метка меню в строке меню или в другом меню, в котором это меню является подменю.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

Меню

public Menu(String label,
            boolean tearOff)
     throws HeadlessException

Создаёт новое меню с указанной меткой, указывающей, можно ли отделить меню.

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

Параметры:
label - метка меню в строке меню или в другом меню, в котором это меню является подменю.
tearOff - если true, меню является выпадающим меню.
Исключения:
HeadlessException - если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

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

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

removeNotify

public void removeNotify()

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

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

isTearOff

public boolean isTearOff()

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

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

Возвращает:
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 - добавляемый элемент меню
Возвращает:
добавляемый элемент меню
См. также:
insert(java.lang.String, int), insert(java.awt.MenuItem, int)

add

public void add(String label)

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

Параметры:
label - текст на элементе
См. также:
insert(java.lang.String, int), insert(java.awt.MenuItem, int)

insert

public void insert(MenuItem menuitem,
                   int index)

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

Параметры:
menuitem - вставляемый элемент меню.
index - позиция, в которую должен быть вставлен элемент меню.
Исключения:
IllegalArgumentException - если значение index меньше нуля
С момента:
1.1
См. также:
add(java.lang.String), add(java.awt.MenuItem)

insert

public void insert(String label,
                   int index)

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

Параметры:
label - текст на элементе
index - позиция, в которую должен быть вставлен элемент меню
Исключения:
IllegalArgumentException - если значение index меньше нуля
С момента:
1.1
См. также:
add(java.lang.String), add(java.awt.MenuItem)

addSeparator

public void addSeparator()

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

См. также:
insertSeparator(int)

insertSeparator

public void insertSeparator(int index)

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

Параметры:
index - позиция, в которую должен быть вставлен разделитель меню.
Исключения:
IllegalArgumentException - если значение index меньше 0.
С момента:
1.1
См. также:
addSeparator()

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

Spec-Zone .ru
спецификации, руководства, описания, API