Spec-Zone.ru › OpenJDK 24

Класс MenuBar

java.lang.Object
java.awt.MenuComponent
java.awt.MenuBar
Все реализованные интерфейсы:
MenuContainer, Serializable, Accessible
public class MenuBar extends MenuComponent implements MenuContainer, Accessible
Класс MenuBar инкапсулирует концепцию меню, привязанного к рамке (frame) платформы. Для связывания панели меню с объектом 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
См. также:
  • Frame
  • Frame.setMenuBar(java.awt.MenuBar)
  • Menu
  • MenuItem
  • MenuShortcut
  • Сериализованная форма

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

Модификатор и тип Класс Описание
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()
Создаёт виджет (peer) для строки меню. Виджет позволяет изменять внешний вид строки меню, не затрагивая её функциональность.

removeNotify

public void removeNotify()
Удаляет виджет (peer) для строки меню. Виджет позволяет изменять внешний вид строки меню, не затрагивая её функциональность.
Переопределяет:
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
См. также:
  • MenuItem
  • MenuShortcut

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, 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/MenuBar.html

Spec-Zone.ru

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