Класс JCheckBox

javax.swing.JCheckBox

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

@JavaBean(description="A component which can be selected or deselected.") public class JCheckBox extends JToggleButton implements Accessible

Реализация флажка — элемента, который можно установить или снять и который отображает свое состояние пользователю. По соглашению в группе можно установить любое количество флажков. Примеры и сведения об использовании флажков см. в разделе Использование кнопок, флажков и переключателей в Учебнике по Java.

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

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

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

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

1.2

См. также:

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

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

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

JToggleButton.AccessibleJToggleButton, JToggleButton.ToggleButtonModel

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

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип	Поле	Описание
`static final String`	`BORDER_PAINTED_FLAT_CHANGED_PROPERTY`	Обозначает изменение свойства flat.

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

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

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

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

Модификатор и тип	Метод	Описание
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JCheckBox.
`String`	`getUIClassID()`	Возвращает строку, задающую имя класса L&F, который отображает этот компонент.
`boolean`	`isBorderPaintedFlat()`	Возвращает значение свойства `borderPaintedFlat`.
`protected String`	`paramString()`	Возвращает строковое представление этого JCheckBox.
`void`	`setBorderPaintedFlat(boolean b)`	Задает свойство `borderPaintedFlat`, которое подсказывает оформлению внешний вид границы флажка.
`void`	`updateUI()`	Сбрасывает свойство UI в значение из текущего оформления.

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

requestFocus, requestFocusInWindow

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

actionPropertyChanged, addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, configurePropertiesFromAction, 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, getSelectedObjects, getText, getUI, getVerticalAlignment, getVerticalTextPosition, imageUpdate, init, isBorderPainted, isContentAreaFilled, isFocusPainted, isRolloverEnabled, isSelected, paintBorder, removeActionListener, removeChangeListener, removeItemListener, removeNotify, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, setHideActionText, setHorizontalAlignment, setHorizontalTextPosition, setIcon, setIconTextGap, setLabel, setLayout, setMargin, setMnemonic, setMnemonic, setModel, 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, 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

Подробное описание полей

BORDER_PAINTED_FLAT_CHANGED_PROPERTY

public static final String BORDER_PAINTED_FLAT_CHANGED_PROPERTY

Обозначает изменение свойства flat.

См. также:

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

JCheckBox

public JCheckBox()

Создает изначально неустановленный флажок без текста и значка.

JCheckBox

public JCheckBox(Icon icon)

Создает изначально неустановленный флажок со значком.

Параметры:: icon — изображение Icon для отображения

JCheckBox

public JCheckBox(Icon icon, boolean selected)

Создает флажок со значком и задает, установлен ли он изначально.

Параметры:: icon — изображение Icon для отображения; selected — логическое значение, указывающее начальное состояние выбора. Если true, флажок установлен

JCheckBox

public JCheckBox(String text)

Создает изначально неустановленный флажок с текстом.

Параметры:: text — текст флажка.

JCheckBox

public JCheckBox(Action a)

Создает флажок, свойства которого задаются переданным объектом Action.

Параметры:: a — объект Action, используемый для настройки нового флажка
Начиная с версии:: 1.3

JCheckBox

public JCheckBox(String text, boolean selected)

Создает флажок с текстом и задает, установлен ли он изначально.

Параметры:: text — текст флажка.; selected — логическое значение, указывающее начальное состояние выбора. Если true, флажок установлен

JCheckBox

public JCheckBox(String text, Icon icon)

Создает изначально неустановленный флажок с указанными текстом и значком.

Параметры:: text — текст флажка.; icon — изображение Icon для отображения

JCheckBox

public JCheckBox(String text, Icon icon, boolean selected)

Создает флажок с текстом и значком и задает, установлен ли он изначально.

Параметры:: text — текст флажка.; icon — изображение Icon для отображения; selected — логическое значение, указывающее начальное состояние выбора. Если true, флажок установлен

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

setBorderPaintedFlat

@BeanProperty(visualUpdate=true, description="Whether the border is painted flat.") public void setBorderPaintedFlat(boolean b)

Задает свойство borderPaintedFlat, которое подсказывает оформлению внешний вид границы флажка. Обычно этому свойству задают значение true, когда экземпляр JCheckBox используется в качестве средства отображения в таком компоненте, как JTable или JTree. Значение свойства borderPaintedFlat по умолчанию — false. Этот метод вызывает событие изменения свойства. Некоторые оформления могут не поддерживать плоские границы и будут игнорировать это свойство.

Параметры:

b — true запрашивает отрисовку плоской границы; false запрашивает обычную границу

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

1.3

См. также:

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

Возвращает значение свойства borderPaintedFlat.

Возвращает:

значение свойства borderPaintedFlat

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

1.3

См. также:

updateUI

public void updateUI()

Сбрасывает свойство UI в значение из текущего оформления.

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

updateUI в классе JToggleButton

См. также:

getUIClassID

@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class") public String getUIClassID()

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

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

getUIClassID в классе JToggleButton

Возвращает:

строку "CheckBoxUI"

См. также:

paramString

protected String paramString()

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

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

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this CheckBox.") public AccessibleContext getAccessibleContext()

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

Определен в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе JToggleButton
Возвращает:: AccessibleJCheckBox, используемый в качестве AccessibleContext этого JCheckBox

© 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/JCheckBox.html