Module  java.desktop
软件包  javax.swing

Class JCheckBoxMenuItem

  • All Implemented Interfaces:
    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方法。

    菜单项可以配置，并在一定程度上控制，由Action s。 使用带有菜单项的Action除了直接配置菜单项之外，还有很多好处。 有关更多详细信息，请参阅Swing Components Supporting Action ，您可以在“Java教程”一节中的 How to Use Actions中找到更多信息。

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

    有关使用复选框菜单项的更多信息和示例，请参阅“Java教程”中的“ How to Use Menus”部分。

    警告： Swing不是线程安全的。 有关详细信息，请参阅Swing's Threading Policy 。

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

    从以下版本开始：
    1.2
    另请参见：
    Serialized Form

    • 构造方法详细信息

      • JCheckBoxMenuItem

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

      • JCheckBoxMenuItem

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

      • JCheckBoxMenuItem

        public JCheckBoxMenuItem​(String text)
        用文本创建一个初始未选择的复选框菜单项。
        参数
        text -该文 JCheckBoxMenuItem

      • JCheckBoxMenuItem

        public JCheckBoxMenuItem​(Action a)
        创建一个菜单项，其属性取自提供的操作。
        参数
        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 - 复选框菜单项的选定状态

    • 方法详细信息

      • getState

        public boolean getState​()
        返回项目的选择状态。 此方法仅适用于AWT兼容性。 新代码应该使用isSelected（）。
        结果
        如果选择项目，则为true

      • setState

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

      • paramString

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

      • getAccessibleContext

        @BeanProperty(bound=false)
public AccessibleContext getAccessibleContext​()
        获取与此JCheckBoxMenuItem关联的AccessibleContext。 对于JCheckBoxMenuItems，AccessibleContext采用AccessibleJCheckBoxMenuItem的形式。 如有必要，将创建一个新的AccessibleJCheckBoxMenuItem实例。
        Specified by:
        getAccessibleContext在接口 Accessible
        重写：
        getAccessibleContext在 JMenuItem
        结果
        an AccessibleJCheckBoxMenuItem that serves as the AccessibleContext of this AccessibleJCheckBoxMenuItem