javax.swing
类 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

复选框的实现，复选框是一个可以被选定和取消选定的项，它将其状态显示给用户。按照惯例，可以选定组中任意数量的复选框。有关使用复选框的示例和信息，请参阅 The Java Tutorial 中的 How to Use Buttons, Check Boxes, and Radio Buttons。

通过 Action 可配置按钮，并进行某种程度的控制。将 Action 用于按钮具有许多直接配置按钮所不及的优点。有关更多详细信息，请参阅支持 Action 的 Swing 组件，可在 The Java Tutorial 中的 How to Use Actions 一节找到更多信息。

警告： Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象将与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 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 标识 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 继承的字段

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

从类 java.awt.Component 继承的字段

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)
创建一个复选框，其属性从所提供的 Action 获取。

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() 获取与此 JCheckBox 关联的 AccessibleContext。
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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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, transferFocusBackward, 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, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, 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 - 要显示的 Icon 图像

JCheckBox

public JCheckBox(Icon icon,
                 boolean selected)

创建一个带图标的复选框，并指定其最初是否处于选定状态。

参数：

icon - 要显示的 Icon 图像

selected - 指示最初选择状态的 boolean 值。如果该参数为 true，则复选框被选定

JCheckBox

public JCheckBox(String text)

创建一个带文本的、最初未被选定的复选框。

参数：

text - 复选框的文本

JCheckBox

public JCheckBox(Action a)

创建一个复选框，其属性从所提供的 Action 获取。

从以下版本开始：

1.3

JCheckBox

public JCheckBox(String text,
                 boolean selected)

创建一个带文本的复选框，并指定其最初是否处于选定状态。

参数：

text - 复选框的文本

selected - 指示最初选择状态的 boolean 值。如果该参数为 true，则复选框被选定

JCheckBox

public JCheckBox(String text,
                 Icon icon)

创建带有指定文本和图标的、最初未选定的复选框。

参数：

text - 复选框的文本

icon - 要显示的 Icon 图像

JCheckBox

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

创建一个带文本和图标的复选框，并指定其最初是否处于选定状态。

参数：

text - 复选框的文本

icon - 要显示的 Icon 图像

selected - 指示最初选择状态的 boolean 值。如果该参数为 true，则复选框被选定

方法详细信息

setBorderPaintedFlat

public void setBorderPaintedFlat(boolean b)

设置 borderPaintedFlat 属性，该属性为外观提供了关于复选框边框外观的提示。在 JCheckBox 实例用作组件（如 JTable 或 JTree）中的渲染器时，该属性通常被设置为 true。borderPaintedFlat 属性的默认值为 false。此方法触发一个属性更改事件。一些外观也许不实现平面边框；它们将忽略此属性。

参数：

b - 为 true 则请求将边框绘制为平面的；为 false 则请求为普通边框

从以下版本开始：

1.3

另请参见：

isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

获取 borderPaintedFlat 属性的值。

返回：

borderPaintedFlat 属性的值

从以下版本开始：

1.3

另请参见：

setBorderPaintedFlat(boolean)

updateUI

public void updateUI()

根据当前外观重置 UI 属性值。

覆盖：

类 JToggleButton 中的 updateUI

另请参见：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回指定呈现此组件的 L&F 类名的字符串。

覆盖：

类 JToggleButton 中的 getUIClassID

返回：

字符串 "CheckBoxUI"

另请参见：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

paramString

protected String paramString()

返回此 JCheckBox 的字符串表示形式。此方法仅在进行调试的时候使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。JFC 组件的一些特定的新的方面。

覆盖：

类 JToggleButton 中的 paramString

返回：

a 此 JCheckBox 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此 JCheckBox 关联的 AccessibleContext。对于 JCheckBoxes，AccessibleContext 采用 AccessibleJCheckBox 的形式。如有必要，可创建一个新的 AccessibleJCheckBox 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 JToggleButton 中的 getAccessibleContext

返回：

一个 AccessibleJCheckBox，它将充当此 JCheckBox 的 AccessibleContext