Класс 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 Tutorial для примеров и информации о использовании флажков.

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

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

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

С:

1.2

См. также:

JRadioButton

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

Модификатор и тип	Класс	Описание
`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()

Создаёт кнопку типа "флажок" (check box) по умолчанию, не выбранную, без текста и иконки.

JCheckBox

public JCheckBox(Icon icon)

Создаёт кнопку типа "флажок" (check box) по умолчанию, не выбранную, с иконкой.

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

JCheckBox

public JCheckBox(Icon icon, boolean selected)

Создаёт кнопку типа "флажок" (check box) с иконкой и задаёт, выбрана она по умолчанию или нет.

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

JCheckBox

public JCheckBox(String text)

Создаёт кнопку типа "флажок" (check box) по умолчанию, не выбранную, с текстом.

Параметры:: text — текст кнопки типа "флажок".

JCheckBox

public JCheckBox(Action a)

Создаёт кнопку типа "флажок" (check box), свойства которой берутся из предоставленного объекта Action.

Параметры:: a — объект Action для задания свойств новой кнопки типа "флажок"
С версии:: 1.3

JCheckBox

public JCheckBox(String text, boolean selected)

Создаёт кнопку типа "флажок" (check box) с текстом и задаёт, выбрана она по умолчанию или нет.

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

JCheckBox

public JCheckBox(String text, Icon icon)

Создаёт кнопку типа "флажок" (check box) по умолчанию, не выбранную, с заданным текстом и иконкой.

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

JCheckBox

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

Создаёт кнопку типа "флажок" (check box) с текстом и иконкой, и задаёт, выбрана она по умолчанию или нет.

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

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

setBorderPaintedFlat

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

Устанавливает свойство borderPaintedFlat, которое даёт подсказку виджету о том, как должен выглядеть виджет "флажок" (check box). Это обычно устанавливается в true при использовании экземпляра JCheckBox в качестве рендерера в компоненте, таком как JTable или JTree. Значение свойства borderPaintedFlat по умолчанию — false. Этот метод генерирует событие изменения свойства. Некоторые виджеты могут не реализовывать плоские рамки; они проигнорируют это свойство.

Параметры:

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

С версии:

1.3

См. также:

isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

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

Возвращает:

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

С версии:

1.3

См. также:

setBorderPaintedFlat(boolean)

updateUI

public void updateUI()

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

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

updateUI в классе JToggleButton

См. также:

JComponent.updateUI()

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