Spec-Zone.ru › OpenJDK 17

Класс JCheckBoxMenuItem

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
javax.swing.JMenuItem
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, а также в разделе Как использовать действия в учебнике Java Tutorial.

Иногда требуется выбрать несколько элементов меню со списком выбора из меню. В этом случае полезно, что щелчок по одному элементу меню со списком выбора не закрывает меню. Это поведение можно контролировать, либо с помощью клиентского свойства 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 Tutorial.

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

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

Since:
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, setModel, 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, 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, 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

Методы, объявленные в классе 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, 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()
Создаёт элемент меню типа флажок (check box), изначально не выбранный, без текста и иконки.

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)
Создаёт элемент меню типа флажок (check box), изначально не выбранный, с иконкой.
Параметры:
icon - иконка JCheckBoxMenuItem.

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)
Создаёт элемент меню типа флажок (check box), изначально не выбранный, с текстом.
Параметры:
text - текст JCheckBoxMenuItem.

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)
Создаёт элемент меню, свойства которого взяты из объекта Action.
Параметры:
a - объект Action JCheckBoxMenuItem.
С момента:
1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text, Icon icon)
Создаёт элемент меню типа флажок (check box), изначально не выбранный, со строкой текста и иконкой.
Параметры:
text - текст JCheckBoxMenuItem.
icon - иконка JCheckBoxMenuItem.

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

@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), содержащий метку элемента меню типа флажок (check box), или null, если флажок не выбран.
Определено в:
getSelectedObjects в интерфейсе ItemSelectable
Переопределяет:
getSelectedObjects в классе AbstractButton
Возвращает:
массив, содержащий один объект — текст элемента меню — если элемент выбран; в противном случае null

paramString

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

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим JCheckBoxMenuItem. Для JCheckBoxMenuItems AccessibleContext представлен в виде AccessibleJCheckBoxMenuItem. Новый экземпляр AccessibleJCheckBoxMenuItem создаётся при необходимости.
Определено в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе JMenuItem
Возвращает:
AccessibleJCheckBoxMenuItem, служащий AccessibleContext для этого AccessibleJCheckBoxMenuItem

© 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/javax/swing/JCheckBoxMenuItem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API