Module java.desktop
Package 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
所有已实现的接口:
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, SwingConstants
@JavaBean(description="A component which can be selected or deselected.") public class JCheckBox extends JToggleButton implements Accessible
复选框的实现 - 一种可以选择或取消选择的项目，并向用户显示其状态。按照惯例，组中的任意数量的复选框可以被选中。请参阅The Java Tutorial中的如何使用按钮、复选框和单选按钮以获取有关使用复选框的示例和信息。

按钮可以通过Action进行配置，并在某种程度上进行控制。使用Action与按钮具有许多优点，超出了直接配置按钮。有关更多详细信息，请参阅支持Action的Swing组件，您可以在The Java Tutorial的如何使用Actions部分找到更多信息。

警告: Swing不是线程安全的。有关更多信息，请参阅Swing的线程策略。

警告: 该类的序列化对象将不兼容未来的Swing版本。当前的序列化支持适用于短期存储或在运行相同版本Swing的应用程序之间的RMI。从1.4开始，已将所有JavaBeans的长期存储支持添加到java.beans包中。请参阅XMLEncoder。

自1.2版本起:

  • Field Details

    • BORDER_PAINTED_FLAT_CHANGED_PROPERTY

      public static final String BORDER_PAINTED_FLAT_CHANGED_PROPERTY
      标识对flat属性的更改。
      参见:

  • Constructor Details

    • 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中获取属性的复选框。
      参数:
      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，则复选框被选中

  • Method Details

    • setBorderPaintedFlat

      @BeanProperty(visualUpdate=true, description="Whether the border is painted flat.") public void setBorderPaintedFlat(boolean b)
      设置borderPaintedFlat属性，为外观提供有关复选框边框外观的提示。当将JCheckBox实例用作组件（如JTable或JTree）中的渲染器时，通常将其设置为true。 borderPaintedFlat属性的默认值为false。此方法触发属性更改事件。某些外观可能不实现平面边框；它们将忽略此属性。
      参数:
      b - true请求绘制平面边框；false请求正常边框
      自1.3版本起:
      参见:

    • isBorderPaintedFlat

      public boolean isBorderPaintedFlat()
      获取borderPaintedFlat属性的值。
      返回:
      borderPaintedFlat属性的值
      自1.3版本起:
      参见:

    • updateUI

      public void updateUI()
      重置UI属性为当前外观的值。
      覆盖:
      updateUI 在类 JToggleButton中
      参见:

    • getUIClassID

      @BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class") public String getUIClassID()
      返回一个字符串，指定呈现此组件的L&F类的名称。
      覆盖:
      getUIClassID 在类 JToggleButton中
      返回:
      字符串"CheckBoxUI"
      参见:

    • paramString

      protected String paramString()
      返回此JCheckBox的字符串表示形式。此方法仅用于调试目的，返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空，但不能为null。JFC组件的特定新方面。
      覆盖:
      paramString 在类 JToggleButton中
      返回:
      此JCheckBox的字符串表示形式。

    • getAccessibleContext

      @BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this CheckBox.") public AccessibleContext getAccessibleContext()
      获取与此JCheckBox关联的AccessibleContext。对于JCheckBoxes，AccessibleContext采用AccessibleJCheckBox的形式。如果需要，将创建一个新的AccessibleJCheckBox实例。
      指定者:
      getAccessibleContext 在接口 Accessible中
      覆盖:
      getAccessibleContext 在类 JToggleButton中
      返回:
      作为此JCheckBox的AccessibleContext的AccessibleJCheckBox