Класс JCheckBoxMenuItem

public class JCheckBoxMenuItem
extends JMenuItem
implements SwingConstants, Accessible

Элемент меню, который может быть выбран или снят с выбора. При выборе элемент меню обычно отображается с галочкой рядом с ним. При снятии выбора галочка не отображается. Как и обычный элемент меню, элемент меню типа «флажок» может иметь связанный с ним текст или графический значок, или оба.

Можно использовать isSelected/setSelected или getState/setState для определения/установки состояния выбора элемента меню. Рекомендуемые методы — isSelected и setSelected, которые работают для всех меню и кнопок. Методы getState и setState существуют для совместимости с другими наборами компонентов.

Элементы меню могут быть настроены и в некоторой степени управляемы с помощью Action. Использование Action с элементом меню имеет много преимуществ по сравнению с прямой настройкой элемента меню. Подробнее см. в разделе Swing Компоненты, поддерживающие Action и Как использовать действия в руководстве The Java Tutorial.

Дополнительную информацию и примеры использования элементов меню типа «флажок» см. в разделе Как использовать меню руководства The Java Tutorial.

Предупреждение: Swing не является потокобезопасным. Дополнительную информацию см. в разделе Политика потоков Swing.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или удаленного вызова метода (RMI) между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. См. XMLEncoder.

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

JCheckBoxMenuItem

public JCheckBoxMenuItem()

Создаёт пункт меню типа флажок (check box), который изначально не выбран, без текста и иконки.

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)

Создаёт пункт меню типа флажок (check box), который изначально не выбран, с иконкой.

Параметры:

icon - иконка пункта меню CheckBoxMenuItem.

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

Создаёт пункт меню типа флажок (check box), который изначально не выбран, с текстом.

Параметры:

text - текст пункта меню CheckBoxMenuItem

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

Создаёт пункт меню, свойства которого берутся из переданного Action.

Since:

1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         Icon icon)

Создаёт пункт меню типа флажок (check box), который изначально не выбран, со специфированным текстом и иконкой.

Параметры:

text - текст пункта меню CheckBoxMenuItem

icon - иконка пункта меню CheckBoxMenuItem

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         boolean b)

Создаёт пункт меню типа флажок (check box) со специфированным текстом и состоянием выбора.

Параметры:

text - текст пункта меню типа флажок (check box).

b - состояние выбора пункта меню типа флажок (check box)

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         Icon icon,
                         boolean b)

Создаёт пункт меню типа флажок (check box) со специфированным текстом, иконкой и состоянием выбора.

Параметры:

text - текст пункта меню типа флажок (check box)

icon - иконка пункта меню типа флажок (check box)

b - состояние выбора пункта меню типа флажок (check box)

Методы

getUIClassID

public String getUIClassID()

Возвращает имя класса L&F, который отображает этот компонент.

Overrides:

getUIClassID в классе JMenuItem

Возвращает:

"CheckBoxMenuItemUI"

См. также:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getState

public boolean getState()

Возвращает состояние выбора элемента. Этот метод существует только для совместимости с AWT. Новый код должен использовать isSelected() вместо него.

Возвращает:

true, если элемент выбран

setState

public void setState(boolean b)

Устанавливает состояние выбора элемента. Этот метод существует только для совместимости с AWT. Новый код должен использовать setSelected() вместо него.

Параметры:

b - логическое значение, указывающее состояние выбора элемента, где true=выбран

getSelectedObjects

public Object[] getSelectedObjects()

Возвращает массив (длиной 1) содержащий метку пункта меню типа флажок (check box), или null, если флажок не выбран.

Specified by:

getSelectedObjects в интерфейсе ItemSelectable

Overrides:

getSelectedObjects в классе AbstractButton

Возвращает:

массив, содержащий один объект — текст пункта меню, — если элемент выбран; иначе null

paramString

protected String paramString()

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

Overrides:

paramString в классе JMenuItem

Возвращает:

строковое представление JCheckBoxMenuItem.

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Specified by:

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

Overrides:

getAccessibleContext в классе JMenuItem

Возвращает:

AccessibleJCheckBoxMenuItem, который служит AccessibleContext для этого AccessibleJCheckBoxMenuItem