JavaTM 2 Platform
Standard Ed. 5.0

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

警告:此类的序列化对象将与以后的 Swing 版本不兼容。当前的序列化支持适用于短期存储或运行相同 Swing 版本的应用程序之间的 RMI。从 1.4 版本开始,已在 java.beans 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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.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)
          创建一个带文本和图标的复选框,并指定其最初是否处于选定状态。
 
方法摘要
protected  void configurePropertiesFromAction(Action a)
          该工厂方法根据 Action 实例的值设置 ActionEvent 源的属性。
protected  PropertyChangeListener createActionPropertyChangeListener(Action a)
          该工厂方法创建 PropertyChangeListener,在 Action 实例上进行属性更改时,用于更新 ActionEvent 源。
 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 继承的方法
addActionListener, addChangeListener, addImpl, addItemListener, checkHorizontalKey, checkVerticalKey, createActionListener, createChangeListener, createItemListener, doClick, doClick, fireActionPerformed, fireItemStateChanged, fireStateChanged, getAction, getActionCommand, getActionListeners, getChangeListeners, getDisabledIcon, getDisabledSelectedIcon, getDisplayedMnemonicIndex, 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, setAction, setActionCommand, setBorderPainted, setContentAreaFilled, setDisabledIcon, setDisabledSelectedIcon, setDisplayedMnemonicIndex, setEnabled, setFocusPainted, 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, 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, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, 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 实例用作组件(如 JTableJTree)中的渲染器时,该属性通常被设置为 trueborderPaintedFlat 属性的默认值为 false。此方法触发一个属性更改事件。一些外观也许不实现平面边框;它们将忽略此属性。

参数:
b - 为 true 则请求将边框绘制为平面的;为 false 则请求普通边框
另请参见:
isBorderPaintedFlat()

isBorderPaintedFlat

public boolean isBorderPaintedFlat()
获得 borderPaintedFlat 属性的值。

返回:
borderPaintedFlat 属性的值
另请参见:
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)

configurePropertiesFromAction

protected void configurePropertiesFromAction(Action a)
该工厂方法根据 Action 实例的值设置 ActionEvent 源的属性。所设置的属性可能随子类的不同而不同。默认情况下,设置的属性为 Text、Mnemonic、Enabled、ActionCommandMnemoToolTipTextnic

覆盖:
AbstractButton 中的 configurePropertiesFromAction
参数:
a - 获取其属性的 Action,或者为 null
从以下版本开始:
1.3
另请参见:
Action, AbstractButton.setAction(javax.swing.Action)

createActionPropertyChangeListener

protected PropertyChangeListener createActionPropertyChangeListener(Action a)
该工厂方法创建 PropertyChangeListener,在 Action 实例上进行属性更改时,用于更新 ActionEvent 源。如果需要更新的属性集合与默认属性(Text、Icon、Enabled 和 ToolTipText)不同,则子类可以重写它,以提供它们自己的 PropertyChangeListener。 注意,PropertyChangeListeners 应避免对 ActionEvent 源的强引用,因为这会妨碍 ActionEvent 源及其容器层次结构中的所有组件的垃圾回收。

覆盖:
AbstractButton 中的 createActionPropertyChangeListener
参数:
a - 按钮的新操作
从以下版本开始:
1.3
另请参见:
Action, AbstractButton.setAction(javax.swing.Action)

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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策