模块  java.desktop
软件包  java.awt

Class CheckboxMenuItem

  • 实现的所有接口
    ItemSelectable ， Serializable ， Accessible 
    public class CheckboxMenuItem
extends MenuItem
implements ItemSelectable, Accessible
    此类表示可以包含在菜单中的复选框。 选择菜单中的复选框会将其状态从“开”更改为“关”或从“关”更改为“开”。

    下图描绘了一个包含CheckBoxMenuItem实例的CheckBoxMenuItem ：

    菜单标记为示例，包含基本，简单，检查等示例。 Check项是CheckBoxMenuItem实例，处于关闭状态。

    标记为Check的项目显示处于“关闭”状态的复选框菜单项。

    选中复选框菜单项后，AWT会向项目发送项目事件。 由于事件是ItemEvent的实例，因此processEvent方法检查事件并将其传递给processItemEvent 。 后一种方法将事件重定向到已注册对此菜单项生成的项事件感兴趣的任何ItemListener对象。

    从以下版本开始：
    1.0
    另请参见：
    ItemEvent ， ItemListener ， Serialized Form

    • 构造方法详细信息

      • CheckboxMenuItem

        public CheckboxMenuItem​(String label)
                 throws HeadlessException
        创建具有指定标签的复选框菜单项。 项目的状态最初设置为“关闭”。
        参数
        label - 复选框菜单项的字符串标签，或 null用于未标记的菜单项。
        异常
        HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true
        另请参见：
        GraphicsEnvironment.isHeadless()

      • CheckboxMenuItem

        public CheckboxMenuItem​(String label,
                        boolean state)
                 throws HeadlessException
        创建具有指定标签和状态的复选框菜单项。
        参数
        label - 复选框菜单项的字符串标签，或 null用于未标记的菜单项。
        state - 菜单项的初始状态，其中 true表示“on”， false表示“off”。
        异常
        HeadlessException - 如果GraphicsEnvironment.isHeadless（）返回true
        从以下版本开始：
        1.1
        另请参见：
        GraphicsEnvironment.isHeadless()

    • 方法详细信息

      • addNotify

        public void addNotify()
        创建复选框项的对等项。 此对等项允许我们更改复选框项的外观而不更改其功能。 大多数应用程序不直接调用此方法。
        重写：
        addNotify在类 MenuItem
        另请参见：
        Component.getToolkit()

      • getState

        public boolean getState()
        确定此复选框菜单项的状态是“开”还是“关”。
        结果
        此复选框菜单项的状态，其中 true表示“on”， false表示“off”
        另请参见：
        setState(boolean)

      • setState

        public void setState​(boolean b)
        将此复选框菜单项设置为指定的状态。 布尔值true表示“on”，而false表示“off”。

        请注意，此方法应主要用于初始化复选框菜单项的状态。 以编程方式设置复选框菜单项的状态将不会触发ItemEvent 。 触发ItemEvent的唯一方法是通过用户交互。

        参数
        b - true如果复选框菜单项已打开，否则为 false
        另请参见：
        getState()

      • getSelectedObjects

        public Object[] getSelectedObjects()
        返回包含复选框菜单项标签的数组（长度为1），如果未选中该复选框，则返回null。
        Specified by:
        getSelectedObjects在界面 ItemSelectable
        结果
        所选对象的列表，或 null
        另请参见：
        ItemSelectable

      • getListeners

        public <T extends EventListener> T[] getListeners​(类<T> listenerType)
        返回当前注册的所有对象的数组FooListener在这个S CheckboxMenuItem 。 FooListener s使用addFooListener方法注册。

        您可以使用类文字指定listenerType参数，例如FooListener.class 。 例如，您可以使用以下代码查询CheckboxMenuItem c的项目侦听器： 

          ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class));
        如果不存在此类侦听器，则此方法返回空数组。
        重写：
        getListeners在类 MenuItem
        参数类型
        T - 侦听器的类型
        参数
        listenerType - 请求的侦听器类型; 此参数应指定一个从java.util.EventListener下降的接口
        结果
        在此复选框menuitem上注册为 FooListener的所有对象的数组，如果未添加此类侦听器，则为空数组
        异常
        ClassCastException - 如果 listenerType未指定实现 java.util.EventListener的类或接口
        从以下版本开始：
        1.3
        另请参见：
        getItemListeners()

      • processEvent

        protected void processEvent​(AWTEvent e)
        处理此复选框菜单项上的事件。 如果事件是ItemEvent的实例，则此方法将调用processItemEvent方法。 如果事件不是项事件，则在超类上调用processEvent 。

        复选框菜单项目前仅支持项目事件。

        请注意，如果事件参数为null则行为未指定，可能会导致异常。

        重写：
        processEvent在类 MenuItem
        参数
        e - 活动
        从以下版本开始：
        1.1
        另请参见：
        ItemEvent ， processItemEvent(java.awt.event.ItemEvent)

      • processItemEvent

        protected void processItemEvent​(ItemEvent e)
        处理在此复选框菜单项上发生的项事件，方法是将它们分派给任何已注册的ItemListener对象。

        除非为此菜单项启用了项目事件，否则不会调用此方法。 发生以下任一情况时启用项目事件：

        • ItemListener对象是通过addItemListener注册的。
        • 项目事件通过enableEvents启用。

        请注意，如果事件参数为null则行为未指定，可能会导致异常。

        参数
        e - 项目事件
        从以下版本开始：
        1.1
        另请参见：
        ItemEvent ， ItemListener ， addItemListener(java.awt.event.ItemListener) ， MenuItem.enableEvents(long)

      • paramString

        public String paramString()
        返回表示此CheckBoxMenuItem的状态的字符串。 此方法仅用于调试目的，返回字符串的内容和格式可能因实现而异。 返回的字符串可能为空，但可能不是null 。
        重写：
        paramString在类 MenuItem
        结果
        此复选框菜单项的参数字符串

      • getAccessibleContext

        public AccessibleContext getAccessibleContext()
        获取与此CheckboxMenuItem关联的AccessibleContext。 对于复选框菜单项，AccessibleContext采用AccessibleAWTCheckboxMenuItem的形式。 如有必要，将创建一个新的AccessibleAWTCheckboxMenuItem。
        Specified by:
        getAccessibleContext在界面 Accessible
        重写：
        getAccessibleContext在类 MenuItem
        结果
        一个AccessibleAWTCheckboxMenuItem，用作此CheckboxMenuItem的AccessibleContext
        从以下版本开始：
        1.3