模块  java.desktop
软件包  javax.swing

Class 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方法以与其他组件集兼容。

    可以通过Action配置菜单项，并在某种程度上控制。 将Action与菜单项一起使用除了直接配置菜单项外，还有许多其他好处。 有关更多详细信息，请参阅Swing Components Supporting Action ，您可以在“Java教程”中的How to Use Actions部分中找到更多信息。

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

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

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

    警告：此类的序列化对象与以后的Swing版本不兼容。 当前的序列化支持适用于运行相同版本Swing的应用程序之间的短期存储或RMI。 从1.4开始， java.beans软件包中添加了对所有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)
        创建一个菜单项，其属性取自提供的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 - 复选框菜单项的选定状态

    • 方法详细信息

      • 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 - 一个布尔值，表示项目的selected-state，其中true = selected

      • 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