Класс CheckboxMenuItem
- Все реализованные интерфейсы:
-
ItemSelectable,Serializable,Accessible
public class CheckboxMenuItem extends MenuItem implements ItemSelectable, Accessible
На рисунке ниже показано меню, содержащее экземпляр CheckBoxMenuItem:
Элемент с надписью Check отображает элемент меню с флажком в состоянии «выключено».
При выборе элемента меню с флажком AWT отправляет событие элемента в элемент. Поскольку событие является экземпляром ItemEvent, метод processEvent проверяет событие и передает его processItemEvent. Последний метод перенаправляет событие любым объектам ItemListener, которые зарегистрировали интерес к событиям элементов, сгенерированным этим элементом меню.
- С момента:
- 1.0
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
CheckboxMenuItem.AccessibleAWTCheckboxMenuItem |
Внутренний класс CheckboxMenuItem, используемый для предоставления стандартной поддержки доступности. |
Вложенные классы/интерфейсы, объявленные в классе java.awt.MenuItem
MenuItem.AccessibleAWTMenuItem
Вложенные классы/интерфейсы, объявленные в классе java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
CheckboxMenuItem() |
Создаёт элемент меню с флажком с пустой меткой. |
CheckboxMenuItem |
Создаёт элемент меню с флажком со заданной меткой. |
CheckboxMenuItem |
Создаёт элемент меню с флажком со заданной меткой и состоянием. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addItemListener |
Добавляет указанного обработчика событий элементов для получения событий элементов от данного элемента меню с флажком. |
void |
addNotify() |
Создаёт виджет элемента флажка. |
AccessibleContext |
getAccessibleContext() |
Получает AccessibleContext, связанный с этим элементом CheckboxMenuItem. |
ItemListener[] |
getItemListeners() |
Возвращает массив всех обработчиков событий элементов, зарегистрированных в данном элементе меню с флажком. |
<T extends EventListener> |
getListeners |
Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListener в данном CheckboxMenuItem. |
Object[] |
getSelectedObjects() |
Возвращает массив (длиной 1) содержащий метку элемента меню с флажком или null, если флажок не выбран. |
boolean |
getState() |
Определяет, находится ли состояние данного элемента меню с флажком в состоянии «включено» или «выключено». |
String |
paramString() |
Возвращает строку, представляющую состояние данного CheckBoxMenuItem. |
protected void |
processEvent |
Обрабатывает события в этом элементе меню с флажком. |
protected void |
processItemEvent |
Обрабатывает события элементов, происходящие в этом элементе меню с флажком, перенаправляя их любым зарегистрированным ItemListener объектам. |
void |
removeItemListener |
Удаляет указанного обработчика событий элементов, чтобы он больше не получал события элементов от этого элемента меню с флажком. |
void |
setState |
Устанавливает состояние этого элемента меню с флажком в указанное состояние. |
Методы, объявленные в классе java.awt.MenuItem
addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getShortcut, isEnabled, processActionEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
Методы, объявленные в классе java.awt.MenuComponent
dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, removeNotify, setFont, setName, toString
Подробное описание конструкторов
CheckboxMenuItem
public CheckboxMenuItem() throws HeadlessException
- Исключение:
-
HeadlessException— если GraphicsEnvironment.isHeadless() возвращает true - С тех пор:
- 1.1
- См. также:
CheckboxMenuItem
public CheckboxMenuItem(String label) throws HeadlessException
- Параметры:
-
label— строковая метка элемента меню типа флажок, илиnullдля элемента меню без метки. - Исключение:
-
HeadlessException— если GraphicsEnvironment.isHeadless() возвращает true - См. также:
CheckboxMenuItem
public CheckboxMenuItem(String label, boolean state) throws HeadlessException
- Параметры:
-
label— строковая метка элемента меню типа флажок, илиnullдля элемента меню без метки. -
state— начальное состояние элемента меню, гдеtrueозначает «включён», аfalse— «выключён». - Исключение:
-
HeadlessException— если GraphicsEnvironment.isHeadless() возвращает true - С тех пор:
- 1.1
- См. также:
Подробное описание методов
addNotify
public void addNotify()
- Переопределяет:
-
addNotifyв классеMenuItem - См. также:
getState
public boolean getState()
- Возвращает:
- состояние этого элемента меню типа флажок, где
trueозначает «включён», аfalse— «выключён» - См. также:
setState
public void setState(boolean b)
true означает «включён», а false — «выключён». Обратите внимание, что этот метод следует использовать в основном для инициализации состояния элемента меню типа флажок. Программная установка состояния элемента меню типа флажок не вызовет ItemEvent. Единственный способ вызвать ItemEvent — взаимодействие пользователя.
- Параметры:
-
b—trueесли элемент меню типа флажок включён, иначеfalse - См. также:
getSelectedObjects
public Object[] getSelectedObjects()
- Определено в:
-
getSelectedObjectsв интерфейсеItemSelectable - Возвращает:
- список выбранных объектов или
null - См. также:
addItemListener
public void addItemListener(ItemListener l)
См. Вопросы по потокам AWT для получения подробной информации о модели потоков AWT.
- Определено в:
-
addItemListenerв интерфейсеItemSelectable - Параметры:
-
l— слушатель событий - С тех пор:
- 1.1
- См. также:
removeItemListener
public void removeItemListener(ItemListener l)
См. Вопросы по потокам AWT для получения подробной информации о модели потоков AWT.
- Определено в:
-
removeItemListenerв интерфейсеItemSelectable - Параметры:
-
l— слушатель событий - С тех пор:
- 1.1
- См. также:
getItemListeners
public ItemListener[] getItemListeners()
- Возвращает:
- все слушатели событий элементов этого элемента меню типа флажок или пустой массив, если слушатели событий элементов в настоящее время не зарегистрированы
- С тех пор:
- 1.4
- См. также:
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener этого элемента CheckboxMenuItem. Слушатели событий регистрируются с помощью метода addFooListener. Вы можете указать параметр listenerType с помощью литерала класса, например, FooListener.class. Например, вы можете запросить слушателей событий элементов для CheckboxMenuItem c с помощью следующего кода:
ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));Если таких слушателей нет, этот метод возвращает пустой массив.
- Переопределяет:
-
getListenersв классеMenuItem - Тип параметров:
-
T— тип слушателей - Параметры:
-
listenerType— тип запрашиваемых слушателей; этот параметр должен указывать интерфейс, являющийся потомкомjava.util.EventListener - Возвращает:
- массив всех объектов, зарегистрированных как слушатели событий
FooListenerв этом элементе меню типа флажок, или пустой массив, если такие слушатели не были добавлены - Исключение:
-
ClassCastException— еслиlistenerTypeне указывает класс или интерфейс, реализующийjava.util.EventListener - С тех пор:
- 1.3
- См. также:
processEvent
protected void processEvent(AWTEvent e)
ItemEvent, этот метод вызывает метод processItemEvent. Если событие не является событием элемента, он вызывает processEvent в суперклассе. Элементы меню типа флажок в настоящее время поддерживают только события элементов.
Обратите внимание, что если параметр события — null, поведение не определено и может привести к исключению.
- Переопределяет:
-
processEventв классеMenuItem - Параметры:
-
e— событие - С тех пор:
- 1.1
- См. также:
Обработка события ItemEvent
protected void processItemEvent(ItemEvent e)
ItemListener объектам. Этот метод не вызывается, если события item не включены для данного пункта меню. События item включаются, когда происходит одно из следующих событий:
- Объект
ItemListenerзарегистрирован с помощьюaddItemListener. - События item включены с помощью
enableEvents.
Обратите внимание, что если параметр события null поведение не определено и может привести к исключению.
- Параметры:
-
e- событие item - С тех пор:
- 1.1
- См. также:
paramString
public String paramString()
CheckBoxMenuItem. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.- Переопределяет:
-
paramStringв классеMenuItem - Возвращает:
- строка параметров этого пункта меню со списком чекбоксов
getAccessibleContext
public AccessibleContext getAccessibleContext()
- Задано в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеMenuItem - Возвращает:
- AccessibleAWTCheckboxMenuItem, который служит AccessibleContext этого элемента CheckboxMenuItem
- С тех пор:
- 1.3
© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/CheckboxMenuItem.html