CheckboxMenuItem (Java Platform SE 8 )

java.lang.Object
- java.awt.MenuComponent
- - java.awt.MenuItem
  - - java.awt.CheckboxMenuItem

All Implemented Interfaces:

ItemSelectable， Serializable， Accessible
```
public class CheckboxMenuItem
extends MenuItem
implements ItemSelectable, Accessible
```
这个类代表一个可以包含在菜单中的复选框。在菜单中选择复选框改变它的状态从“上”到“关”或“断”到“
下图描述了一个菜单，其中包含CheckBoxMenuItem实例：

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

当一个复选框，选择菜单项，AWT事件发送一个项目的项目。因为事件是ItemEvent实例的方法，processEvent检测事件并传递给processItemEvent。后一种方法是将事件的已注册事件，这项菜单项产生兴趣的任何ItemListener对象。
。”

从以下版本开始：

JDK1.0

另请参见：

ItemEvent， ItemListener， Serialized Form

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`CheckboxMenuItem.AccessibleAWTCheckboxMenuItem` 用于提供访问默认支持菜单项的内部类。

Nested classes/interfaces inherited from class java.awt.MenuItem
MenuItem.AccessibleAWTMenuItem

Nested classes/interfaces inherited from class java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent

构造方法摘要

构造方法
Constructor and Description
`CheckboxMenuItem()` 创建一个带有空标签的复选框菜单项。
`CheckboxMenuItem(String label)` 用指定的标签创建一个复选框菜单项。
`CheckboxMenuItem(String label, boolean state)` 用指定的标签和状态创建一个复选框菜单项。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`addItemListener(ItemListener l)` 将指定的项目侦听器添加到从这个复选框菜单项中接收项目事件。
`void`	`addNotify()` 创建复选框项同行。
`AccessibleContext`	`getAccessibleContext()` 获取与该菜单项关联的accessiblecontext。
`ItemListener[]`	`getItemListeners()` 返回所有项目的听众对这个复选框菜单项注册一个数组。
`<T extends EventListener> T[]`	`getListeners(类<T> listenerType)` 返回对象的当前注册为 `FooListener`s在这 `CheckboxMenuItem`数组。
`Object[]`	`getSelectedObjects()` 返回一个数组（长度1）包含复选框菜单项标签或空如果没有勾选。
`boolean`	`getState()` 确定此复选框菜单项的状态是否为“上”或“关闭”。
`String`	`paramString()` 返回一个字符串，表示此 `CheckBoxMenuItem`状态。
`protected void`	`processEvent(AWTEvent e)` 在这个复选框菜单项上处理事件。
`protected void`	`processItemEvent(ItemEvent e)` 流程项目事件发生在此复选框菜单项派遣他们任何注册 `ItemListener`对象。
`void`	`removeItemListener(ItemListener l)` 移除指定的项目侦听器，以便它不再接收从这个复选框菜单项中的项目事件。
`void`	`setState(boolean b)` 将此复选框菜单项设置为指定的状态。

Methods inherited from class java.awt.MenuItem
addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getShortcut, isEnabled, processActionEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut

Methods inherited from class java.awt.MenuComponent
dispatchEvent, getFont, getName, getParent, getPeer, getTreeLock, postEvent, removeNotify, setFont, setName, toString

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - CheckboxMenuItem
```
public CheckboxMenuItem()
                 throws HeadlessException
```
    创建一个带有空标签的复选框菜单项。该项目的状态最初设置为“关闭”。
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
  - 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表示“上”和“下 false指示。”
    
    异常
    
    HeadlessException -如果graphicsenvironment isheadless()返回true。
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()
- 方法详细信息
  - addNotify
```
public void addNotify()
```
    创建复选框项同行。这一点让我们改变复选框项的外观没有改变其功能。大多数应用程序不直接调用此方法。
    
    重写：
    
    addNotify 方法重写，继承类 MenuItem
    
    另请参见：
    
    Toolkit.createCheckboxMenuItem(java.awt.CheckboxMenuItem)， Component.getToolkit()
  - getState
```
public boolean getState()
```
    确定此复选框菜单项的状态是否为“上”或“关闭”。
    
    结果
    
    此复选框菜单项的状态，在 true表示“上”和“关闭” false指示
    
    另请参见：
    
    setState(boolean)
  - setState
```
public void setState(boolean b)
```
    将此复选框菜单项设置为指定的状态。布尔值 true表示“对”而 false表示“关”。
    请注意，此方法应主要用于初始化复选框菜单项的状态。以编程方式设置菜单项的复选框的状态将空不触发ItemEvent。触发ItemEvent通过用户交互的唯一方式。
    
    参数
    
    b - true如果复选框菜单项，否则 false
    
    另请参见：
    
    getState()
  - getSelectedObjects
```
public Object[] getSelectedObjects()
```
    返回一个数组（长度1）包含复选框菜单项标签或空如果没有勾选。
    
    Specified by:
    
    getSelectedObjects 接口 ItemSelectable
    
    另请参见：
    
    ItemSelectable
  - addItemListener
```
public void addItemListener(ItemListener l)
```
    将指定的项目侦听器添加到从这个复选框菜单项中接收项目事件。项目事件来响应用户操作，发送，但不响应呼吁setstate()。如果L为空，则不会引发异常，并没有执行任何动作。
    参考AWT Threading Issues对AWT的线程模型的细节。
    
    Specified by:
    
    addItemListener 接口 ItemSelectable
    
    参数
    
    l -项目的倾听者
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    removeItemListener(java.awt.event.ItemListener)， getItemListeners()， setState(boolean)， ItemEvent， ItemListener
  - removeItemListener
```
public void removeItemListener(ItemListener l)
```
    移除指定的项目侦听器，以便它不再接收从这个复选框菜单项中的项目事件。如果L为空，则不会引发异常，并没有执行任何动作。
    参考AWT Threading Issues对AWT的线程模型的细节。
    
    Specified by:
    
    removeItemListener 接口 ItemSelectable
    
    参数
    
    l -项目的倾听者
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    addItemListener(java.awt.event.ItemListener)， getItemListeners()， ItemEvent， ItemListener
  - getItemListeners
```
public ItemListener[] getItemListeners()
```
    返回所有项目的听众对这个复选框菜单项注册一个数组。
    
    结果
    
    所有这些复选框菜单项的 ItemListeners或空数组如果没有项目的听众正在注册
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    addItemListener(java.awt.event.ItemListener)， removeItemListener(java.awt.event.ItemListener)， ItemEvent， ItemListener
  - getListeners
```
public <T extends EventListener> T[] getListeners(类<T> listenerType)
```
    返回对象的当前注册为 FooListeners在这 CheckboxMenuItem数组。 FooListeners使用 addFooListener方法注册。如果没有这样
    您可以指定一个类的listenerType字面的说法，如FooListener.class。例如，你可以查询其产品的听众与下面的代码一CheckboxMenuItem c：
```
itemlistener [] ILS =（itemlistener [ ]）（c.getlisteners（itemlistener。类））；
```
    听众的存在，此方法将返回空数组。
    重写：
    
    getListeners 方法重写，继承类 MenuItem
    
    参数
    
    listenerType -听众的类型要求；这个参数应该指定一个接口，从 java.util.EventListener
    
    结果
    
    所有对象注册为该复选框菜单 FooListeners数组，或一个空数组如果没有这样的听众已添加
    
    异常
    
    ClassCastException -如果 listenerType不指定一个类或接口实现 java.util.EventListener
    
    从以下版本开始：
    
    一点三
    
    另请参见：
    
    getItemListeners()
  - processEvent
```
protected void processEvent(AWTEvent e)
```
    在这个复选框菜单项上处理事件。如果事件是 ItemEvent实例，该方法调用 processItemEvent方法。如果事件不是一项活动，它调用父类的 processEvent上。
    复选框菜单项目前只支持项目事件。
    
    注意，如果参数是null行为是不可能导致异常。
    
    重写：
    
    processEvent 方法重写，继承类 MenuItem
    
    参数
    
    e -事件
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ItemEvent， processItemEvent(java.awt.event.ItemEvent)
  - processItemEvent
```
protected void processItemEvent(ItemEvent e)
```
    流程项目事件发生在此复选框菜单项派遣他们任何注册 ItemListener对象。
    此方法不被调用，除非此菜单项启用了项目事件。当下列情况之一发生时，启用项目事件：
    - 一个ItemListener对象是通过addItemListener注册。
    - 项目活动能够通过enableEvents。
    注意，如果参数是null行为是不可能导致异常。
    参数
    
    e -项目活动
    
    从以下版本开始：
    
    JDK1.1
    
    另请参见：
    
    ItemEvent， ItemListener， addItemListener(java.awt.event.ItemListener)， MenuItem.enableEvents(long)
  - paramString
```
public String paramString()
```
    返回一个字符串，表示此 CheckBoxMenuItem状态。此方法仅用于调试目的，返回的字符串的内容和格式可能会在实现过程中有所不同。返回的字符串是空的但可能不 null。
    
    重写：
    
    paramString 方法重写，继承类 MenuItem
    
    结果
    
    此复选框菜单项的参数字符串
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与该菜单项关联的accessiblecontext。为菜单项的复选框，accessiblecontext以一个accessibleawtcheckboxmenuitem形式。一个新的accessibleawtcheckboxmenuitem创造必要的。
    
    Specified by:
    
    getAccessibleContext 接口 Accessible
    
    重写：
    
    getAccessibleContext 方法重写，继承类 MenuItem
    
    结果
    
    一个accessibleawtcheckboxmenuitem作为该菜单项的accessiblecontext
    
    从以下版本开始：
    
    一点三

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class CheckboxMenuItem

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.MenuItem

Nested classes/interfaces inherited from class java.awt.MenuComponent

构造方法摘要

方法摘要

Methods inherited from class java.awt.MenuItem

Methods inherited from class java.awt.MenuComponent

Methods inherited from class java.lang.Object

Constructor Detail

CheckboxMenuItem

CheckboxMenuItem

CheckboxMenuItem

方法详细信息

addNotify

getState

setState

getSelectedObjects

addItemListener

removeItemListener

getItemListeners

getListeners

processEvent

processItemEvent

paramString

getAccessibleContext