Класс 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, используемый для предоставления поддержки доступности по умолчанию.

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

MenuComponent.AccessibleAWTMenuComponent

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

Конструктор	Описание
`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`, связанный с этим элементом меню.

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

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

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 Threading Issues для получения подробностей о модели потоков AWT.

Параметры:

l - обработчик событий действия.

С тех пор:

1.1

См. также:

removeActionListener

public void removeActionListener(ActionListener l)

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

Обратитесь к Проблемам потоков AWT для получения подробной информации о модели потоков AWT.

Parameters:

l - обработчик событий действия.

Since:

1.1

See Also:

getActionListeners

public ActionListener[] getActionListeners()

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

Returns:

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

Since:

1.4

See Also:

getListeners

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

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

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

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

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

Type Parameters:

T - тип обработчиков

Parameters:

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

Returns:

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

Throws:

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

Since:

1.3

See Also:

processEvent

protected void processEvent(AWTEvent e)

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

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

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

Overrides:

processEvent в классе MenuComponent

Parameters:

e - событие

Since:

1.1

See Also:

processActionEvent

protected void processActionEvent(ActionEvent e)

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

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

Parameters:

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

Since:

1.1

See Also:

paramString

public String paramString()

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

Overrides:: paramString в классе MenuComponent
Returns:: строка параметров этого пункта меню

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:: getAccessibleContext в интерфейсе Accessible
Overrides:: getAccessibleContext в классе MenuComponent
Returns:: AccessibleAWTMenuItem, который служит AccessibleContext этого пункта меню
Since:: 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/MenuItem.html