Класс 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 Components Supporting Action и в разделе Как использовать действия в руководстве по Java.

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

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

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

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

С:
1.2
См. также:
Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem

Этот класс реализует поддержку доступности для класса JCheckBoxMenuItem.

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

JMenuItem.AccessibleJMenuItem

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

Сводка полей

Поля, объявленные в классе javax.swing.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

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

Поля, объявленные в интерфейсе javax.swing.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)

Создаёт элемент меню, свойства которого взяты из предоставленного действия.
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)

Устанавливает состояние выбора элемента.

Методы, объявленные в классе javax.swing.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, setUI, updateUI

Методы, объявленные в классе javax.swing.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, setModel, setMultiClickThreshhold, setPressedIcon, setRolloverEnabled, setRolloverIcon, setRolloverSelectedIcon, setSelected, setSelectedIcon, setText, setUI, setVerticalAlignment, setVerticalTextPosition

Методы, объявленные в классе javax.swing.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, 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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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, hide, 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

Методы, объявленные в классе java.lang.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"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

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, 2020, 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/11/docs/api/java.desktop/javax/swing/JCheckBoxMenuItem.html

Spec-Zone .ru
спецификации, руководства, описания, API