Класс 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
См. также:
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 String BORDER_PAINTED_FLAT_CHANGED_PROPERTY

Идентифицирует изменение свойства плоского.

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

Создаёт чекбокс, свойства которого берутся из предоставленного действия.

Параметры:
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()

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"
См. также:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

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. Для JCheckBoxes AccessibleContext принимает вид AccessibleJCheckBox. Новый AccessibleJCheckBox создаётся при необходимости.

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

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

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