java.awt

Class CheckboxMenuItem

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的实例的CheckBoxMenuItem ：

标有Check的项目显示“关闭”状态下的复选框菜单项。

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

从以下版本开始：

JDK1.0

另请参见：

ItemEvent ， ItemListener ， Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	CheckboxMenuItem.AccessibleAWTCheckboxMenuItem 用于提供对辅助功能的默认支持的CheckboxMenuItem的内部类。

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() 获取与此CheckboxMenuItem关联的AccessibleContext。
ItemListener[]	getItemListeners() 返回在此复选框菜单上注册的所有项目侦听器的数组。
<T extends EventListener> T[]	getListeners(类<T> listenerType) 返回当前注册为 FooListener的所有对象的数组，该对象为 CheckboxMenuItem 。
Object[]	getSelectedObjects() 返回包含复选框菜单项标签的数组（长度1），如果未选中复选框，则返回null。
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

构造方法详细信息

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），如果未选中复选框，则返回null。

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()

返回在此复选框菜单上注册的所有项目侦听器的数组。

结果

所有这个复选框menuitem的 ItemListener s或一个空数组，如果没有项目监听器当前注册

从以下版本开始：

1.4

另请参见：

addItemListener(java.awt.event.ItemListener) ， removeItemListener(java.awt.event.ItemListener) ， ItemEvent ， ItemListener

getListeners

public <T extends EventListener> T[] getListeners(类<T> listenerType)

返回当前注册为FooListener的所有对象的数组，此对象为CheckboxMenuItem 。 FooListener使用addFooListener方法注册。

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

  ItemListener[] ils = (ItemListener[])(c.getListeners(ItemListener.class)); 

如果没有这样的侦听器存在，这个方法返回一个空数组。

重写：

getListeners在类别 MenuItem

参数

listenerType - 所请求的听众的类型; 此参数应指定从java.util.EventListener

结果

在这个复选框menuitem上注册为 FooListener的所有对象的数组，如果没有添加这样的侦听器，则是一个空数组

异常

ClassCastException - 如果 listenerType没有指定实现java.util.EventListener的类或 java.util.EventListener

从以下版本开始：

1.3

另请参见：

getItemListeners()

processEvent

protected void processEvent(AWTEvent e)

处理此复选框菜单项上的事件。 如果事件是ItemEvent一个实例， ItemEvent此方法调用processItemEvent方法。 如果事件不是项目事件，它将在processEvent上调用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()

获取与此CheckboxMenuItem关联的AccessibleContext。 对于复选框菜单项，AccessibleContext采用AccessibleAWTCheckboxMenuItem的形式。 如有必要，将创建一个新的AccessibleAWTCheckboxMenuItem。

Specified by:

getAccessibleContext在界面 Accessible

重写：

getAccessibleContext在类别 MenuItem

结果

一个AccessibleAWTCheckboxMenuItem，用作此CheckboxMenuItem的AccessibleContext

从以下版本开始：

1.3