Класс 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, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. Пожалуйста, см. XMLEncoder.

С момента:

1.2

См. также:

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

Модификатор и тип	Класс	Описание
`protected class`	`JCheckBox.AccessibleJCheckBox`	Этот класс реализует поддержку доступности для класса `JCheckBox`.

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

JToggleButton.AccessibleJToggleButton, JToggleButton.ToggleButtonModel

Вложенные классы/интерфейсы, объявленные в классе 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

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

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

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

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

Конструктор	Описание
`JCheckBox()`	Создаёт кнопку-флажок, изначально не выбранную, без текста и иконки.
`JCheckBox(String text)`	Создаёт флажок с текстом, изначально не выбранный.
`JCheckBox(String text, boolean selected)`	Создаёт флажок с текстом и задаёт, выбран ли он изначально.
`JCheckBox(String text, Icon icon)`	Создаёт флажок с текстом и иконкой, изначально не выбранный.
`JCheckBox(String text, Icon icon, boolean selected)`	Создаёт флажок с текстом и иконкой, и задаёт, выбран ли он изначально.
`JCheckBox(Action a)`	Создаёт флажок, где свойства берутся из предоставленного действия.
`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 до значения из текущего внешнего вида.

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

requestFocus, requestFocusInWindow

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

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

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

BORDER_PAINTED_FLAT_CHANGED_PROPERTY

public static final String BORDER_PAINTED_FLAT_CHANGED_PROPERTY

Идентифицирует изменение свойства flat.

См. также:

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

JCheckBox

public JCheckBox()

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

JCheckBox

public JCheckBox(Icon icon)

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

Параметры:: icon - изображение-значок для отображения

JCheckBox

public JCheckBox(Icon icon, boolean selected)

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

Параметры:: 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 - изображение-значок для отображения

JCheckBox

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

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

Параметры:: text - текст флажка.; 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JCheckBox.html