Класс MenuItem

java.lang.Object

java.awt.MenuComponent

java.awt.MenuItem

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

Непосредственные известные подклассы:: CheckboxMenuItem, Menu

public class MenuItem extends MenuComponent implements Accessible

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

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

На этом изображении строки меню показаны пять элементов меню: The following text describes this
graphic.
Первые два элемента — простые элементы меню с метками "Basic" и "Simple". За этими двумя элементами следует разделитель, который также является элементом меню, созданным с меткой "-". Далее идет экземпляр CheckboxMenuItem с меткой "Check". Последний элемент меню — подменю с меткой "More Examples"; это подменю является экземпляром Menu.

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

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

См. также:

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

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

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

MenuComponent.AccessibleAWTMenuComponent

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

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

Конструктор	Описание
`MenuItem()`	Создает новый MenuItem с пустой меткой и без сочетания клавиш.
`MenuItem(String label)`	Создает новый MenuItem с указанной меткой и без сочетания клавиш.
`MenuItem(String label, MenuShortcut s)`	Создает элемент меню, связанный с сочетанием клавиш.

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

Модификатор и тип	Метод	Описание
`void`	`addActionListener(ActionListener l)`	Добавляет указанный прослушиватель действий для получения событий действий от этого элемента меню.
`void`	`addNotify()`	Создает одноранговый объект элемента меню.
`void`	`deleteShortcut()`	Удаляет любой объект `MenuShortcut`, связанный с этим элементом меню.
`void`	`disable()`	Устарело. Начиная с версии JDK 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`disableEvents(long eventsToDisable)`	Отключает доставку этому элементу меню событий, определенных указанной маской событий.
`void`	`enable()`	Устарело. Начиная с версии JDK 1.1 заменено на `setEnabled(boolean)`.
`void`	`enable(boolean b)`	Устарело. Начиная с версии JDK 1.1 заменено на `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Включает доставку этому элементу меню событий, определенных указанной маской событий
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим MenuItem.
`String`	`getActionCommand()`	Возвращает имя команды события действия, создаваемого этим элементом меню.
`ActionListener[]`	`getActionListeners()`	Возвращает массив всех прослушивателей действий, зарегистрированных для этого элемента меню.
`String`	`getLabel()`	Возвращает метку этого элемента меню.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Возвращает массив всех объектов, зарегистрированных в данный момент как `FooListener` для этого `MenuItem`.
`MenuShortcut`	`getShortcut()`	Возвращает объект `MenuShortcut`, связанный с этим элементом меню,
`boolean`	`isEnabled()`	Проверяет, включен ли этот элемент меню.
`String`	`paramString()`	Возвращает строку, представляющую состояние этого `MenuItem`.
`protected void`	`processActionEvent(ActionEvent e)`	Обрабатывает события действий, возникающие в этом элементе меню, отправляя их всем зарегистрированным объектам `ActionListener`.
`protected void`	`processEvent(AWTEvent e)`	Обрабатывает события этого элемента меню.
`void`	`removeActionListener(ActionListener l)`	Удаляет указанный прослушиватель действий, чтобы он больше не получал события действий от этого элемента меню.
`void`	`setActionCommand(String command)`	Задает имя команды события действия, создаваемого этим элементом меню.
`void`	`setEnabled(boolean b)`	Задает, можно ли выбрать этот элемент меню.
`void`	`setLabel(String label)`	Задает указанную метку для этого элемента меню.
`void`	`setShortcut(MenuShortcut s)`	Задает объект `MenuShortcut`, связанный с этим элементом меню.

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

dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, removeNotify, setFont, setName, toString

Модификатор и тип	Метод	Описание
`final void`	`dispatchEvent(AWTEvent e)`	Передает событие этому компоненту или одному из его подкомпонентов.
`Font`	`getFont()`	Возвращает шрифт, используемый для этого компонента меню.
`String`	`getName()`	Возвращает имя компонента меню.
`MenuContainer`	`getParent()`	Возвращает родительский контейнер этого компонента меню.
`protected final Object`	`getTreeLock()`	Возвращает объект блокировки этого компонента (объект, которому принадлежит монитор синхронизации потоков) для операций с деревом компонентов и компоновкой AWT.
`boolean`	`postEvent(Event evt)`	Устарело. Начиная с версии JDK 1.1 заменено на `dispatchEvent`.
`void`	`removeNotify()`	Удаляет одноранговый объект компонента меню.
`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, либо до истечения заданного промежутка реального времени.

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

MenuItem

public MenuItem() throws HeadlessException

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

Вызывает исключение:

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

Начиная с:

1.1

См. также:

MenuItem

public MenuItem(String label) throws HeadlessException

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

Параметры:

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

Вызывает исключение:

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

Начиная с:

1.0

См. также:

MenuItem

public MenuItem(String label, MenuShortcut s) throws HeadlessException

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

Параметры:

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

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

Вызывает исключение:

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

Начиная с:

1.1

См. также:

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

addNotify

public void addNotify()

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

getLabel

public String getLabel()

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

Возвращает:

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

Начиная с:

1.0

См. также:

setLabel

public void setLabel(String label)

Задает этому пункту меню указанную метку.

Параметры:

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

Начиная с:

1.0

См. также:

isEnabled

public boolean isEnabled()

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

Возвращает:

true, если пункт включен; в противном случае — false

Начиная с:

1.0

См. также:

setEnabled

public void setEnabled(boolean b)

Задает, можно ли выбрать этот пункт меню.

Параметры:

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

Начиная с:

1.1

См. также:

enable

@Deprecated public void enable()

Устарел.

Начиная с JDK версии 1.1 заменен на setEnabled(boolean).

enable

@Deprecated public void enable(boolean b)

Устарел.

Начиная с JDK версии 1.1 заменен на setEnabled(boolean).

Задает, можно ли выбрать этот пункт меню.

Параметры:: b - если true, включает этот пункт меню; в противном случае отключает его

disable

@Deprecated public void disable()

Устарел.

Начиная с JDK версии 1.1 заменен на setEnabled(boolean).

getShortcut

public MenuShortcut getShortcut()

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

Возвращает:

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

Начиная с:

1.1

См. также:

setShortcut

public void setShortcut(MenuShortcut s)

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

Параметры:

s - сочетание клавиш меню, которое нужно связать с этим пунктом меню.

Начиная с:

1.1

См. также:

deleteShortcut

public void deleteShortcut()

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

Начиная с:: 1.1

enableEvents

protected final void enableEvents(long eventsToEnable)

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

Поскольку типы событий автоматически включаются при добавлении к пункту меню слушателя соответствующего типа, этот метод требуется вызывать только подклассам MenuItem, которым необходимо получать указанные типы событий в processEvent независимо от наличия зарегистрированного слушателя.

Параметры:

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

Начиная с:

1.1

См. также:

disableEvents

protected final void disableEvents(long eventsToDisable)

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

Параметры:

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

Начиная с:

1.1

См. также:

setActionCommand

public void setActionCommand(String command)

Задает имя команды события действия, генерируемого этим пунктом меню.

По умолчанию в качестве команды действия используется метка пункта меню.

Параметры:

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

Начиная с:

1.1

См. также:

getActionCommand

public String getActionCommand()

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

Возвращает:

имя команды действия

Начиная с:

1.1

См. также:

addActionListener

public void addActionListener(ActionListener l)

Добавляет указанный слушатель действий для получения событий действия от этого пункта меню. Если l равно null, исключение не возникает и никаких действий не выполняется.

Подробные сведения о модели многопоточности AWT см. в разделе Проблемы многопоточности AWT.

Параметры:

l - слушатель действий.

Начиная с:

1.1

См. также:

removeActionListener

public void removeActionListener(ActionListener l)

Удаляет указанный слушатель действий, чтобы он больше не получал события действия от этого пункта меню. Если l равно null, исключение не возникает и никаких действий не выполняется.

Подробные сведения о модели многопоточности AWT см. в разделе Проблемы многопоточности AWT.

Параметры:

l - слушатель действий.

Начиная с:

1.1

См. также:

getActionListeners

public ActionListener[] getActionListeners()

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

Возвращает:

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

Начиная с:

1.4

См. также:

getListeners

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

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

В аргументе listenerType можно указать литерал класса, например FooListener.class. Например, можно запросить у MenuItem m список его слушателей действий с помощью следующего кода:

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

Если таких слушателей нет, этот метод возвращает пустой массив.

Параметры типа:

T - тип слушателей

Параметры:

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

Возвращает:

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

Вызывает исключение:

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

Начиная с:

1.3

См. также:

processEvent

protected void processEvent(AWTEvent e)

Обрабатывает события этого пункта меню. Если событие является экземпляром ActionEvent, вызывается processActionEvent — другой метод, определенный в MenuItem.

В настоящее время пункты меню поддерживают только события действия.

Обратите внимание: если параметр event равен null, поведение не определено и может привести к исключению.

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

processEvent в классе MenuComponent

Параметры:

e - событие

Начиная с:

1.1

См. также:

processActionEvent

protected void processActionEvent(ActionEvent e)

Обрабатывает события действия, возникающие в этом пункте меню, передавая их всем зарегистрированным объектам ActionListener. Этот метод вызывается только в том случае, если для компонента включены события действия. События действия включаются в следующих случаях:

Объект ActionListener зарегистрирован с помощью addActionListener.
События действия включены с помощью enableEvents.

Обратите внимание: если параметр event равен null, поведение не определено и может привести к исключению.

Параметры:

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

Начиная с:

1.1

См. также:

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

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