Класс MenuBar

java.lang.Object

java.awt.MenuComponent

java.awt.MenuBar

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

public class MenuBar extends MenuComponent implements MenuContainer, Accessible

Класс MenuBar инкапсулирует концепцию панели меню платформы, связанной со фреймом. Для того, чтобы связать панель меню с объектом Frame, вызовите метод setMenuBar фрейма.

Вот как может выглядеть панель меню:

Diagram of MenuBar containing 2 menus: Examples and Options. Examples
menu is expanded showing items: Basic, Simple, Check, and More Examples.

Панель меню обрабатывает сочетания клавиш для элементов меню, передавая их своим дочерним меню. (Сочетания клавиш, которые являются необязательными, предоставляют пользователю альтернативу мыши для вызова элемента меню и связанного с ним действия.) Каждый элемент меню может содержать экземпляр MenuShortcut. Класс MenuBar определяет несколько методов, shortcuts() и getShortcutMenuItem(java.awt.MenuShortcut), которые извлекают информацию о сочетаниях клавиш, управляемых данной панелью меню.

С момента:

1.0

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`MenuBar.AccessibleAWTMenuBar`	Внутренний класс MenuBar, используемый для предоставления стандартной поддержки доступности.

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

MenuComponent.AccessibleAWTMenuComponent

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

Конструктор	Описание
`MenuBar()`	Создает новую панель меню.

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

Модификатор и тип	Метод	Описание
`Menu`	`add(Menu m)`	Добавляет указанное меню к панели меню.
`void`	`addNotify()`	Создает виджет панели меню.
`int`	`countMenus()`	Устарело. Начиная с версии JDK 1.1, заменено на `getMenuCount()`.
`void`	`deleteShortcut(MenuShortcut s)`	Удаляет указанное сочетание клавиш.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим MenuBar.
`Menu`	`getHelpMenu()`	Возвращает меню справки на панели меню.
`Menu`	`getMenu(int i)`	Возвращает указанное меню.
`int`	`getMenuCount()`	Возвращает количество меню на панели меню.
`MenuItem`	`getShortcutMenuItem(MenuShortcut s)`	Возвращает экземпляр `MenuItem`, связанный с указанным объектом `MenuShortcut`, или `null`, если ни один из элементов меню, управляемых этой панелью меню, не связан с указанным сочетанием клавиш.
`void`	`remove(int index)`	Удаляет меню, расположенное в указанном индексе, из этой панели меню.
`void`	`remove(MenuComponent m)`	Удаляет указанный компонент меню из этой панели меню.
`void`	`removeNotify()`	Удаляет виджет панели меню.
`void`	`setHelpMenu(Menu m)`	Устанавливает указанное меню в качестве меню справки этой панели меню.
`Enumeration<MenuShortcut>`	`shortcuts()`	Возвращает перечисление всех сочетаний клавиш, которые управляет эта панель меню.

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

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

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

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

Методы, унаследованные от интерфейса java.awt.MenuContainer

getFont, postEvent

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

MenuBar

public MenuBar() throws HeadlessException

Создаёт новую строку меню.

Выбрасывает:

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

См. также:

GraphicsEnvironment.isHeadless()

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

addNotify

public void addNotify()

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

removeNotify

public void removeNotify()

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

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

getHelpMenu

public Menu getHelpMenu()

Возвращает меню справки в строке меню.

Возвращает:: меню справки в этой строке меню.

setHelpMenu

public void setHelpMenu(Menu m)

Устанавливает указанное меню в качестве меню справки этой строки меню. Если в строке меню уже есть меню справки, старое меню справки удаляется, и на его место устанавливается указанное меню.

Параметры:: m - меню, которое нужно установить в качестве меню справки

add

public Menu add(Menu m)

Добавляет указанное меню в строку меню. Если меню уже было частью другой строки меню, удаляет его из той строки меню.

Параметры:

m - добавляемое меню

Возвращает:

добавлено меню

См. также:

remove(int)
remove(java.awt.MenuComponent)

remove

public void remove(int index)

Удаляет меню, расположенное по указанному индексу, из этой строки меню.

Параметры:

index - позиция удаляемого меню.

См. также:

add(java.awt.Menu)

remove

public void remove(MenuComponent m)

Удаляет указанный компонент меню из этой строки меню.

Определяет:

remove в интерфейсе MenuContainer

Параметры:

m - удаляемый компонент меню.

См. также:

add(java.awt.Menu)

getMenuCount

public int getMenuCount()

Возвращает количество меню в строке меню.

Возвращает:: количество меню в строке меню.
С:: 1.1

countMenus

@Deprecated public int countMenus()

Устарело.

С версии JDK 1.1 заменено на getMenuCount().

Возвращает количество меню в строке меню.

Возвращает:: количество меню в строке меню.

getMenu

public Menu getMenu(int i)

Возвращает указанное меню.

Параметры:: i - позиция индекса возвращаемого меню.
Возвращает:: меню по указанному индексу в этой строке меню.

shortcuts

public Enumeration<MenuShortcut> shortcuts()

Возвращает перечисление всех ярлыков меню, которые управляет эта строка меню.

Возвращает:

перечисление ярлыков меню, которые управляет эта строка меню.

С:

1.1

См. также:

MenuShortcut

getShortcutMenuItem

public MenuItem getShortcutMenuItem(MenuShortcut s)

Возвращает экземпляр MenuItem связанный с указанным объектом MenuShortcut, или null, если ни один из пунктов меню, управляемых этой строкой меню, не связан с указанным ярлыком меню.

Параметры:

s - указанный ярлык меню.

Возвращает:

пункт меню для указанного ярлыка.

С:

1.1

См. также:

deleteShortcut

public void deleteShortcut(MenuShortcut s)

Удаляет указанный ярлык меню.

Параметры:: s - ярлык меню для удаления.
С:: 1.1

getAccessibleContext

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этой строкой меню. Для строк меню AccessibleContext представлен в виде AccessibleAWTMenuBar. Новый экземпляр AccessibleAWTMenuBar создаётся при необходимости.

Определяет:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе MenuComponent
Возвращает:: AccessibleAWTMenuBar, служащий 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/MenuBar.html