javax.swing

Class JCheckBox

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.AbstractButton

javax.swing.JToggleButton

javax.swing.JCheckBox

All Implemented Interfaces:

ImageObserver， ItemSelectable， MenuContainer， Serializable， Accessible， SwingConstants

public class JCheckBox
extends JToggleButton
implements Accessible

一个复选框的实现，可以选择或取消选择一项，并显示其状态的用户。根据惯例，可以选择在一组中的任意数量的复选框。看到的例子和信息的java教程 How to Use Buttons, Check Boxes, and Radio Buttons使用复选框。

按钮可配置，并在一定程度上控制，通过Actions。使用Action用按钮直接配置按钮之外的许多好处。参考 Swing Components Supporting Action更多细节，你可以在How to Use Actions找到更多信息，java教程中的一部分。

警告： Swing是线程不安全的。更多信息见Swing's Threading Policy。

警告：序列化该类的对象与以后的Swing版本不兼容。当前的序列化支持适用于短期贮藏或RMI运行相同Swing版本的应用程序之间。为1.4，为所有JavaBeans™长期存储的支持已被添加到java.beans包。请看XMLEncoder。

另请参见：

JRadioButton

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	JCheckBox.AccessibleJCheckBox 这个类实现了对 JCheckBox类可访问性支持。

Nested classes/interfaces inherited from class javax.swing.JToggleButton

JToggleButton.AccessibleJToggleButton, JToggleButton.ToggleButtonModel

Nested classes/interfaces inherited from class javax.swing.AbstractButton

AbstractButton.AccessibleAbstractButton, AbstractButton.ButtonChangeListener

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
static String	BORDER_PAINTED_FLAT_CHANGED_PROPERTY 标识平坦属性的更改。

Fields inherited from class 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

Fields inherited from class javax.swing.JComponent

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

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface 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

Fields inherited from interface java.awt.image.ImageObserver

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

构造方法摘要

构造方法

Constructor and Description
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) 创建一个带有文本和图标的复选框，并指定它是否最初选择。

方法摘要

Modifier and Type	Method and Description
AccessibleContext	getAccessibleContext() 获取与此相关的accessiblecontext复选框。
String	getUIClassID() 返回一个字符串，指定呈现此组件的“L”和“F”类的名称。
boolean	isBorderPaintedFlat() 得到的 borderPaintedFlat属性的值。
protected String	paramString() 返回此复选框的字符串表示。
void	setBorderPaintedFlat(boolean b) 集 borderPaintedFlat财产，这给出了一个暗示的外观和感觉为复选框的边框外观。
void	updateUI() 重置UI属性从目前看价值和感觉。

Methods inherited from class 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

Methods inherited from class 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

Methods inherited from class 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

Methods inherited from class 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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

BORDER_PAINTED_FLAT_CHANGED_PROPERTY

public static final String BORDER_PAINTED_FLAT_CHANGED_PROPERTY

标识平坦属性的更改。

另请参见：

Constant Field Values

Constructor Detail

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)

创建一个检查框，属性从所提供的操作中取出。

从以下版本开始：

一点三

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请求正常的边界

从以下版本开始：

一点三

另请参见：

isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()

得到的 borderPaintedFlat属性的值。

结果

该 borderPaintedFlat属性的值

从以下版本开始：

一点三

另请参见：

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()

返回此复选框的字符串表示。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null，JFC组件的特定的新方面。

重写：

paramString 方法重写，继承类 JToggleButton

结果

此复选框的字符串表示。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获取与此相关的accessiblecontext复选框。JCheckBoxes的accessiblecontext以一个accessiblejcheckbox形式。一个新的accessiblejcheckbox实例被创建时。

Specified by:

getAccessibleContext 接口 Accessible

重写：

getAccessibleContext 方法重写，继承类 JToggleButton

结果

一个accessiblejcheckbox作为此复选框的accessiblecontext