Класс JCheckBoxMenuItem

javax.swing.JCheckBoxMenuItem

Все реализуемые интерфейсы:: ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants

@JavaBean(description="A menu item which can be selected or deselected.") public class JCheckBoxMenuItem extends JMenuItem implements SwingConstants, Accessible

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

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

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

Иногда требуется выбрать несколько элементов меню с флажками. В этом случае полезно, чтобы щелчок по одному такому элементу не закрывал меню. Такое поведение можно настроить с помощью клиентского свойства JComponent.putClientProperty(Object, Object) или свойства UIManager.put(Object, Object) внешнего вида (Look and Feel) с именем "CheckBoxMenuItem.doNotCloseOnMouseClick". Значение по умолчанию — false. Если задать свойству значение true, меню не будет закрываться при щелчке мышью. Если задано клиентское свойство, всегда используется его значение; в противном случае проверяется свойство L&F. Примечание: некоторые L&F могут игнорировать это свойство. Все встроенные L&F наследуют это поведение.

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

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

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

Начиная с версии:: 1.2

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

Модификатор и тип	Класс	Описание
`protected class`	`JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem`	Этот класс реализует поддержку специальных возможностей для класса `JCheckBoxMenuItem`.

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

JMenuItem.AccessibleJMenuItem

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Краткое описание полей

Поля, объявленные в классе AbstractButton

actionListener, BORDER_PAINTED_CHANGED_PROPERTY, changeEvent, changeListener, CONTENT_AREA_FILLED_CHANGED_PROPERTY, DISABLED_ICON_CHANGED_PROPERTY, DISABLED_SELECTED_ICON_CHANGED_PROPERTY, FOCUS_PAINTED_CHANGED_PROPERTY, HORIZONTAL_ALIGNMENT_CHANGED_PROPERTY, HORIZONTAL_TEXT_POSITION_CHANGED_PROPERTY, ICON_CHANGED_PROPERTY, itemListener, MARGIN_CHANGED_PROPERTY, MNEMONIC_CHANGED_PROPERTY, model, MODEL_CHANGED_PROPERTY, PRESSED_ICON_CHANGED_PROPERTY, ROLLOVER_ENABLED_CHANGED_PROPERTY, ROLLOVER_ICON_CHANGED_PROPERTY, ROLLOVER_SELECTED_ICON_CHANGED_PROPERTY, SELECTED_ICON_CHANGED_PROPERTY, TEXT_CHANGED_PROPERTY, VERTICAL_ALIGNMENT_CHANGED_PROPERTY, VERTICAL_TEXT_POSITION_CHANGED_PROPERTY

Поля, объявленные в классе JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Поля, объявленные в интерфейсе SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

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

Конструктор	Описание
`JCheckBoxMenuItem()`	Создаёт изначально невыбранный элемент меню с флажком без заданного текста и значка.
`JCheckBoxMenuItem(String text)`	Создаёт изначально невыбранный элемент меню с флажком и текстом.
`JCheckBoxMenuItem(String text, boolean b)`	Создаёт элемент меню с флажком, заданным текстом и состоянием выбора.
`JCheckBoxMenuItem(String text, Icon icon)`	Создаёт изначально невыбранный элемент меню с флажком, заданными текстом и значком.
`JCheckBoxMenuItem(String text, Icon icon, boolean b)`	Создаёт элемент меню с флажком, заданными текстом, значком и состоянием выбора.
`JCheckBoxMenuItem(Action a)`	Создаёт элемент меню, свойства которого берутся из переданного объекта Action.
`JCheckBoxMenuItem(Icon icon)`	Создаёт изначально невыбранный элемент меню с флажком и значком.

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

Модификатор и тип	Метод	Описание
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JCheckBoxMenuItem.
`Object[]`	`getSelectedObjects()`	Возвращает массив (длиной 1), содержащий метку элемента меню с флажком, или null, если флажок не установлен.
`boolean`	`getState()`	Возвращает состояние выбора элемента.
`String`	`getUIClassID()`	Возвращает имя класса L&F, который отображает этот компонент.
`protected String`	`paramString()`	Возвращает строковое представление этого JCheckBoxMenuItem.
`void`	`setState(boolean b)`	Задаёт состояние выбора элемента.

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

actionPropertyChanged, addMenuDragMouseListener, addMenuKeyListener, configurePropertiesFromAction, fireMenuDragMouseDragged, fireMenuDragMouseEntered, fireMenuDragMouseExited, fireMenuDragMouseReleased, fireMenuKeyPressed, fireMenuKeyReleased, fireMenuKeyTyped, getAccelerator, getComponent, getMenuDragMouseListeners, getMenuKeyListeners, getSubElements, init, isArmed, menuSelectionChanged, processKeyEvent, processMenuDragMouseEvent, processMenuKeyEvent, processMouseEvent, removeMenuDragMouseListener, removeMenuKeyListener, setAccelerator, setArmed, setEnabled, setModel, setUI, updateUI

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

addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createActionPropertyChangeListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, getHideActionText, getHorizontalAlignment, getHorizontalTextPosition, getIcon, getIconTextGap, getItemListeners, getLabel, getMargin, getMnemonic, getModel, getMultiClickThreshhold, getPressedIcon, getRolloverIcon, getRolloverSelectedIcon, getSelectedIcon, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

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

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

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

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusDownCycle, validate, validateTree

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

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

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

JCheckBoxMenuItem

public JCheckBoxMenuItem()

Создаёт изначально невыбранный элемент меню с флажком без заданного текста и значка.

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)

Создаёт изначально невыбранный элемент меню с флажком и значком.

Параметры:: icon — значок JCheckBoxMenuItem.

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

Создаёт изначально невыбранный элемент меню с флажком и текстом.

Параметры:: text — текст JCheckBoxMenuItem

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

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

Параметры:: a — действие для JCheckBoxMenuItem
Начиная с версии:: 1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, Icon icon)

Создаёт изначально невыбранный элемент меню с флажком, заданными текстом и значком.

Параметры:: text — текст JCheckBoxMenuItem; icon — значок JCheckBoxMenuItem

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, boolean b)

Создаёт элемент меню с флажком, заданными текстом и состоянием выбора.

Параметры:: text — текст элемента меню с флажком.; b — состояние выбора элемента меню с флажком

JCheckBoxMenuItem

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

Создаёт элемент меню с флажком, заданными текстом, значком и состоянием выбора.

Параметры:: text — текст элемента меню с флажком; icon — значок элемента меню с флажком; b — состояние выбора элемента меню с флажком

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

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

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

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

getUIClassID в классе JMenuItem

Возвращает:

строку "CheckBoxMenuItemUI"

См. также:

getState

public boolean getState()

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

Возвращает:: true, если элемент выбран

setState

@BeanProperty(bound=false, hidden=true, description="The selection state of the check box menu item") public void setState(boolean b)

Задаёт состояние выбора элемента. Этот метод существует только для совместимости с AWT. В новом коде следует использовать setSelected().

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

getSelectedObjects

@BeanProperty(bound=false) public Object[] getSelectedObjects()

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

Определено в:: getSelectedObjects в интерфейсе ItemSelectable
Переопределяет:: getSelectedObjects в классе AbstractButton
Возвращает:: массив, содержащий один объект — текст элемента меню, — если элемент выбран; в противном случае null

paramString

protected String paramString()

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

Переопределяет:: paramString в классе JMenuItem
Возвращает:: строковое представление этого JCheckBoxMenuItem.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

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

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе JMenuItem
Возвращает:: объект AccessibleJCheckBoxMenuItem, выполняющий роль AccessibleContext этого AccessibleJCheckBoxMenuItem

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JCheckBoxMenuItem.html