Класс JCheckBox

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.AbstractButton
      - javax.swing.JToggleButton
        
        javax.swing.JCheckBox

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

public class JCheckBox
extends JToggleButton
implements Accessible

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

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

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

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

См. также:: 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

Поля, унаследованные от интерфейса 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

Поля, унаследованные от интерфейса java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Конструкторы

Конструктор и описание
`JCheckBox()` Создает кнопку флажка, изначально не выбранную, без текста, без значка.
`JCheckBox(Action a)` Создает флажок, где свойства берутся из предоставленного действия.
`JCheckBox(Icon icon)` Создает флажок, изначально не выбранный, со значком.
`JCheckBox(Icon icon, boolean selected)` Создает флажок со значком и указывает, выбран ли он изначально.
`JCheckBox(String text)` Создает флажок, изначально не выбранный, с текстом.
`JCheckBox(String text, boolean selected)` Создает флажок с текстом и указывает, выбран ли он изначально.
`JCheckBox(String text, Icon icon)` Создает флажок, изначально не выбранный, с указанным текстом и значком.
`JCheckBox(String text, 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.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, 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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, 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.

С момента:: 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

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

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

public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JCheckBox. Для JCheckBox контекст 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.