模块  java.desktop
软件包  javax.swing

Class JCheckBoxMenuItem

  • 实现的所有接口
    ImageObserverItemSelectableMenuContainerSerializableAccessibleMenuElementSwingConstants

    @JavaBean(description="A menu item which can be selected or deselected.")
    public class JCheckBoxMenuItem
    extends JMenuItem
    implements SwingConstants, Accessible
    可以选择或取消选择的菜单项。 如果选中,菜单项通常会显示旁边的复选标记。 如果未选中或取消选择,则菜单项不会显示复选标记。 与常规菜单项一样,复选框菜单项可以包含与之关联的文本或图形图标,或两者都有。

    无论是isSelected / setSelectedgetState / setState可以用来确定/指定菜单项的选择状态。 首选方法是isSelectedsetSelected ,它们适用于所有菜单和按钮。 存在getStatesetState方法以与其他组件集兼容。

    可以通过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
        重写:
        paramStringJMenuItem
        结果
        此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