Класс 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 для получения более подробной информации, а также вы можете найти больше информации в Как использовать действия, разделе The Java Tutorial.

Предупреждение: 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, 2023, 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/21/docs/api/java.desktop/javax/swing/JCheckBox.html