模块 java.desktop
包 javax.swing

类 JCheckBoxMenuItem

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.AbstractButton
javax.swing.JMenuItem
javax.swing.JCheckBoxMenuItem
所有已实现的接口：
ImageObserver , ItemSelectable , MenuContainer , Serializable , Accessible , MenuElement , SwingConstants
@JavaBean (description ="A menu item which can be selected or deselected.") public class JCheckBoxMenuItem extends JMenuItem implements SwingConstants , Accessible
可以选择或取消选择的菜单项。如果选中，菜单项通常会显示旁边有一个复选标记。如果未选择或取消选择，则菜单项显示时没有复选标记。与常规菜单项一样，复选框菜单项可以具有与之关联的文本或图形图标，或两者都有。

isSelected /setSelected 或 getState /setState 可用于确定/指定菜单项的选择状态。首选方法是 isSelected 和 setSelected ，它们适用于所有菜单和按钮。 getState 和 setState 方法的存在是为了与其他组件集兼容。

Actions 可以配置菜单项，并在某种程度上控制它们。将Action 与菜单项一起使用比直接配置菜单项有很多好处。有关详细信息，请参阅 摇摆组件支持Action，您可以在 如何使用动作 中找到更多信息，这是 The Java Tutorial 中的一个部分。

有时需要从菜单中选择多个复选框菜单项。在这种情况下，单击一个复选框菜单项不会关闭菜单是很有用的。这种行为可以由客户端 JComponent.putClientProperty(java.lang.Object, java.lang.Object) 或名为 "CheckBoxMenuItem.doNotCloseOnMouseClick" 的外观 UIManager.put(java.lang.Object, java.lang.Object) 属性控制。默认值为 false 。将属性设置为 true 可防止菜单在被鼠标单击时关闭。如果设置了客户端属性，则始终使用其值；否则查询 L&F 属性。注意：某些 L&F 可能会忽略此属性。所有内置的 L&F 都继承了这种行为。

有关使用复选框菜单项的更多信息和示例，请参阅 如何使用菜单，The Java Tutorial. 中的一个部分

Warning: Swing 不是线程安全的。有关详细信息，请参阅 Swing 的线程策略。

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

自从：
1.2

  • 构造方法详细信息

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem()
      创建一个最初未选中的复选框菜单项，没有设置文本或图标。

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem(Icon  icon)
      创建一个带有图标的最初未选中的复选框菜单项。
      参数：
      icon - JCheckBoxMenuItem 的图标。

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem(String  text)
      创建一个最初未选中的带有文本的复选框菜单项。
      参数：
      text - JCheckBoxMenuItem 的文本

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem(Action  a)
      创建一个菜单项，其属性取自提供的 Action。
      参数：
      a - JCheckBoxMenuItem 的动作
      自从：
      1.3

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem(String  text, Icon  icon)
      使用指定的文本和图标创建一个最初未选中的复选框菜单项。
      参数：
      text - JCheckBoxMenuItem 的文本
      icon - JCheckBoxMenuItem 的图标

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem(String  text, boolean b)
      创建具有指定文本和选择状态的复选框菜单项。
      参数：
      text - 复选框菜单项的文本。
      b - 复选框菜单项的选中状态

    • JCheckBoxMenuItem

      public JCheckBoxMenuItem(String  text, Icon  icon, boolean b)
      创建具有指定文本、图标和选择状态的复选框菜单项。
      参数：
      text - 复选框菜单项的文本
      icon - 复选框菜单项的图标
      b - 复选框菜单项的选中状态

  • 方法详情

    • getUIClassID

      @BeanProperty (bound =false) public String  getUIClassID()
      返回呈现此组件的 L&F 类的名称。
      重写：
      getUIClassID 在类 JMenuItem 中
      返回：
      字符串“CheckBoxMenuItemUI”
      参见：

    • getState

      public boolean getState()
      返回项目的选定状态。此方法仅用于 AWT 兼容性。新代码应该改用 isSelected() 。
      返回：
      如果项目被选中则为真

    • setState

      @BeanProperty (bound =false, hidden =true, description ="The selection state of the check box menu item") public void setState(boolean b)
      设置项目的选定状态。此方法仅用于 AWT 兼容性。新代码应该改用 setSelected()。
      参数：
      b - 一个boolean，指示项目的选定状态，其中 true=selected

    • getSelectedObjects

      @BeanProperty (bound =false) public Object [] getSelectedObjects()
      返回包含复选框菜单项标签的数组（长度为 1），如果未选中复选框，则返回 null。
      指定者：
      getSelectedObjects 在接口 ItemSelectable 中
      重写：
      getSelectedObjects 在类 AbstractButton 中
      返回：
      包含一个对象的数组——菜单项的文本——如果该项被选中；否则为空

    • paramString

      protected String  paramString()
      返回此 JCheckBoxMenuItem 的字符串表示形式。此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。返回的字符串可能为空，但可能不是 null 。
      重写：
      paramString 在类 JMenuItem 中
      返回：
      此 JCheckBoxMenuItem 的字符串表示形式。

    • getAccessibleContext

      @BeanProperty (bound =false) public AccessibleContext  getAccessibleContext()
      获取与此 JCheckBoxMenuItem 关联的 AccessibleContext。对于 JCheckBoxMenuItems，AccessibleContext 采用 AccessibleJCheckBoxMenuItem 的形式。如有必要，将创建一个新的 AccessibleJCheckBoxMenuItem 实例。
      指定者：
      getAccessibleContext 在接口 Accessible 中
      重写：
      getAccessibleContext 在类 JMenuItem 中
      返回：
      用作此 AccessibleJCheckBoxMenuItem 的 AccessibleContext 的 AccessibleJCheckBoxMenuItem