Spec-Zone.ru › OpenJDK 27

Класс 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(MenuShortcut), — которые возвращают сведения о сочетаниях клавиш, обрабатываемых данной строкой меню.

Начиная с:
1.0
См. также:
  • Frame
  • Frame.setMenuBar(java.awt.MenuBar)
  • Menu
  • MenuItem
  • MenuShortcut
  • Сериализованная форма

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

Модификатор и тип Класс Описание
protected class  MenuBar.AccessibleAWTMenuBar
Внутренний класс MenuBar, обеспечивающий поддержку специальных возможностей по умолчанию.

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

MenuComponent.AccessibleAWTMenuComponent
Модификатор и тип Класс Описание
protected class  MenuComponent.AccessibleAWTMenuComponent
Внутренний класс MenuComponent, обеспечивающий поддержку специальных возможностей по умолчанию.

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

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

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

Модификатор и тип Метод Описание
Menu add(Menu m)
Добавляет указанное меню в строку меню.
void addNotify()
Создает peer-объект строки меню.
int countMenus()
Устаревший.
В JDK версии 1.1 заменен на getMenuCount().
void deleteShortcut(MenuShortcut s)
Удаляет указанное сочетание клавиш меню.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этой строкой меню.
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()
Удаляет peer-объект строки меню.
void setHelpMenu(Menu m)
Назначает указанное меню меню справки этой строки меню.
Enumeration<MenuShortcut> shortcuts()
Возвращает перечисление всех сочетаний клавиш меню, обрабатываемых этой строкой меню.

Методы, объявленные в классе MenuComponent

dispatchEvent, getFont, getName, getParent, getTreeLock, paramString, postEvent, processEvent, setFont, setName, toString
Модификатор и тип Метод Описание
final void dispatchEvent(AWTEvent e)
Передает событие этому компоненту или одному из его подкомпонентов.
Font getFont()
Возвращает шрифт, используемый этим компонентом меню.
String getName()
Возвращает имя компонента меню.
MenuContainer getParent()
Возвращает родительский контейнер этого компонента меню.
protected final Object getTreeLock()
Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов и компоновкой AWT.
protected String paramString()
Возвращает строку, представляющую состояние этого MenuComponent.
boolean postEvent(Event evt)
Устаревший.
В JDK версии 1.1 заменен на dispatchEvent.
protected void processEvent(AWTEvent e)
Обрабатывает события, возникающие в этом компоненте меню.
void setFont(Font f)
Задает указанный шрифт для этого компонента меню.
void setName(String name)
Задает указанную строку в качестве имени компонента.
String toString()
Возвращает строковое представление этого компонента меню.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Показывает, равен ли этот объект какому-либо другому объекту.
protected void finalize()
Устаревший, будет удален: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе MenuContainer

getFont, postEvent
Модификатор и тип Метод Описание
Font getFont()
Возвращает шрифт, используемый этим контейнером.
boolean postEvent(Event evt)
Устаревший.
В JDK версии 1.1 заменен на dispatchEvent(AWTEvent).

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

MenuBar

public MenuBar() throws HeadlessException
Создает новую строку меню.
Вызывает исключение:
HeadlessException — если GraphicsEnvironment.isHeadless() возвращает true.
См. также:
  • GraphicsEnvironment.isHeadless()

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

addNotify

public void addNotify()
Создает peer-объект строки меню. Peer-объект позволяет изменять внешний вид строки меню, не меняя ее функциональность.

removeNotify

public void removeNotify()
Удаляет peer-объект строки меню. 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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

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