Класс MenuItem

Все элементы меню должны принадлежать классу MenuItem, или одному из его подклассов.

Объект по умолчанию MenuItem воплощает простой элемент меню с меткой.

На этой картинке показана строка меню с пятью элементами:
Первые два элемента — это простые элементы меню, помеченные "Basic" и "Simple". После этих двух элементов идёт разделитель, который сам по себе является элементом меню, созданным с меткой "-". Далее идёт экземпляр CheckboxMenuItem с меткой "Check". Последний элемент меню — подменю с меткой "More Examples", и это подменю является экземпляром Menu.

При выборе элемента меню AWT отправляет событие действия элементу меню. Поскольку событие является экземпляром ActionEvent, метод processEvent проверяет событие и передает его processActionEvent. Последний метод перенаправляет событие любым объектам ActionListener, которые зарегистрировали интерес к событиям действий, генерируемым этим элементом меню.

Обратите внимание, что подкласс Menu переопределяет это поведение и не отправляет никаких событий в фрейм, пока не будет выбран один из его подэлементов.

Конструкторы

MenuItem

public MenuItem()
         throws HeadlessException

Создаёт новый MenuItem с пустым меткой и без сочетания клавиш.

Исключение:

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

С тех пор:

JDK1.1

См. также:

GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String label)
         throws HeadlessException

Создаёт новый MenuItem с указанной меткой и без сочетания клавиш. Обратите внимание, что использование "-" в метке зарезервировано для обозначения разделителя между элементами меню. По умолчанию все элементы меню, кроме разделителей, включены.

Параметры:

label - метка этого элемента меню.

Исключение:

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

С тех пор:

JDK1.0

См. также:

GraphicsEnvironment.isHeadless()

MenuItem

public MenuItem(String label,
                MenuShortcut s)
         throws HeadlessException

Создаёт элемент меню с сопутствующим сочетанием клавиш. Обратите внимание, что использование "-" в метке зарезервировано для обозначения разделителя между элементами меню. По умолчанию все элементы меню, кроме разделителей, включены.

Параметры:

label - метка этого элемента меню.

s - экземпляр MenuShortcut , связанный с этим элементом меню.

Исключение:

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

С тех пор:

JDK1.1

См. также:

GraphicsEnvironment.isHeadless()

Методы

addNotify

public void addNotify()

Создаёт компонент-представитель элемента меню. Представитель позволяет изменить внешний вид элемента меню без изменения его функциональности.

getLabel

public String getLabel()

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

Возвращает:

метку этого элемента меню или null , если у этого элемента меню нет метки.

С тех пор:

JDK1.0

См. также:

setLabel(java.lang.String)

setLabel

public void setLabel(String label)

Устанавливает метку для этого элемента меню на заданную метку.

Параметры:

label - новая метка или null , если метка не нужна.

С тех пор:

JDK1.0

См. также:

getLabel()

isEnabled

public boolean isEnabled()

Проверяет, включен ли данный элемент меню.

С тех пор:

JDK1.0

См. также:

setEnabled(boolean)

setEnabled

public void setEnabled(boolean b)

Устанавливает, может ли быть выбран данный элемент меню.

Параметры:

b - если true, включает данный элемент меню; если false, отключает его.

С тех пор:

JDK1.1

См. также:

isEnabled()

enable

@Deprecated
public void enable()

Устарело. С версии JDK 1.1 заменено на setEnabled(boolean).

enable

@Deprecated
public void enable(boolean b)

Устарело. С версии JDK 1.1 заменено на setEnabled(boolean).

disable

@Deprecated
public void disable()

Устарело. С версии JDK 1.1 заменено на setEnabled(boolean).

getShortcut

public MenuShortcut getShortcut()

Получить объект MenuShortcut , связанный с данным элементом меню.

Возвращает:

сочетание клавиш, связанное с этим элементом меню, или null , если оно не указано.

С тех пор:

JDK1.1

См. также:

setShortcut(java.awt.MenuShortcut)

setShortcut

public void setShortcut(MenuShortcut s)

Установить объект MenuShortcut , связанный с этим элементом меню. Если сочетание клавиш уже связано с этим элементом меню, оно заменяется.

Параметры:

s - сочетание клавиш для связывания с этим элементом меню.

С тех пор:

JDK1.1

См. также:

getShortcut()

deleteShortcut

public void deleteShortcut()

Удалить любой объект MenuShortcut , связанный с этим элементом меню.

С тех пор:

JDK1.1

enableEvents

protected final void enableEvents(long eventsToEnable)

Параметры:

eventsToEnable - маска событий, определяющая типы событий

С тех пор:

JDK1.1

См. также:

processEvent(java.awt.AWTEvent), disableEvents(long), Component.enableEvents(long)

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Параметры:

eventsToDisable - маска событий, определяющая типы событий

С тех пор:

JDK1.1

См. также:

processEvent(java.awt.AWTEvent), enableEvents(long), Component.disableEvents(long)

setActionCommand

public void setActionCommand(String command)

Параметры:

command - команда действия для данного элемента меню.

С тех пор:

JDK1.1

См. также:

getActionCommand()

getActionCommand

public String getActionCommand()

Возвращает имя команды события действия, которое генерируется этим элементом меню.

С тех пор:

JDK1.1

См. также:

setActionCommand(java.lang.String)

addActionListener

public void addActionListener(ActionListener l)

Параметры:

l - слушатель событий действия.

С тех пор:

JDK1.1

См. также:

removeActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

removeActionListener

public void removeActionListener(ActionListener l)

Параметры:

l - слушатель событий действия.

С тех пор:

JDK1.1

См. также:

addActionListener(java.awt.event.ActionListener), getActionListeners(), ActionEvent, ActionListener

getActionListeners

public ActionListener[] getActionListeners()

Возвращает массив всех зарегистрированных слушателей событий действия на этом элементе меню.

Возвращает:

все слушатели событий действия данного элемента меню или пустой массив, если слушателей событий действия не зарегистрировано

С тех пор:

1.4

См. также:

addActionListener(java.awt.event.ActionListener), removeActionListener(java.awt.event.ActionListener), ActionEvent, ActionListener

getListeners

public <T extends EventListener> T[] getListeners(Class<T> listenerType)

ActionListener[] als = (ActionListener[])(m.getListeners(ActionListener.class));

Параметры:

listenerType - тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, унаследованный от java.util.EventListener

Возвращает:

массив всех объектов, зарегистрированных в качестве FooListener для этого элемента меню, или пустой массив, если такие слушатели не были добавлены

Исключение:

ClassCastException - если listenerType не указывает класс или интерфейс, реализующий java.util.EventListener

С тех пор:

1.3

См. также:

getActionListeners()

processEvent

protected void processEvent(AWTEvent e)

Переопределяет:

processEvent в классе MenuComponent

Параметры:

e - событие

С тех пор:

JDK1.1

См. также:

processActionEvent(java.awt.event.ActionEvent)

processActionEvent

protected void processActionEvent(ActionEvent e)

Параметры:

e - событие действия

С тех пор:

JDK1.1

См. также:

ActionEvent, ActionListener, enableEvents(long)

paramString

public String paramString()

Возвращает строку, представляющую состояние этого MenuItem. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.

Переопределяет:

paramString в классе MenuComponent

Возвращает:

строку параметра этого пункта меню

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Определено в:

getAccessibleContext в интерфейсе Accessible

Переопределяет:

getAccessibleContext в классе MenuComponent

Возвращает:

AccessibleAWTMenuItem, который служит AccessibleContext этого MenuItem

С тех пор:

1.3