Класс 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
См. также:: 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()

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

removeNotify

public void removeNotify()

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

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

getHelpMenu

public Menu getHelpMenu()

Получает меню справки в меню.

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

public void setHelpMenu(Menu m)

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

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

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, связанный с этим MenuBar. Для меню контекст AccessibleContext имеет вид AccessibleAWTMenuBar. Новый AccessibleAWTMenuBar создается при необходимости.

Определяется в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе MenuComponent
Возвращает:: AccessibleAWTMenuBar, являющийся AccessibleContext этого MenuBar
С:: 1.3