当前页面:
在线文档首页 >
JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
JCheckBox (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
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
| 从类 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.SwingConstants 继承的字段 |
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST |
| 从类 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 |
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 则请求普通边框- 另请参见：
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、ActionCommand 和 MnemoToolTipTextnic。
- 覆盖：
- 类
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
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。 版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。
