Spec-Zone.ru › OpenJDK 17

Класс Меню

java.lang.Object
java.awt.MenuComponent
java.awt.MenuItem
java.awt.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, 2021, 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/17/docs/api/java.desktop/java/awt/Menu.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API