类 java.awt.CheckboxMenuItem

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

public class CheckboxMenuItem

extends MenuItem

implements ItemSelectable

该类表示可包含在菜单中的一个复选框。单击菜单中的复选框可将其状态从“开”改变到“关”，或从“关”改变到“开”。

下面的图像描述了一个包含 CheckBoxMenuItem 的一个实例的菜单：

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

当一个复选框菜单项被选中时，AWT 发送一个项事件到该菜单项。由于该事件是 ItemEvent 的一个实例，所以 processEvent 方法检查该事件，并将其传送给 processItemEvent 方法。其后的方法将该事件重定向到任意一个对由此菜单项生成的项事件感兴趣的 ItemListener 对象。

来自：

JDK1.0

参见：

ItemEvent, ItemListener

构造子索引

CheckboxMenuItem()

创建一个带空标签的复选框菜单项。

CheckboxMenuItem(String)

用指定的标签创建一个复选框菜单项。

CheckboxMenuItem(String, boolean)

用指定的标签和状态创建一个复选框菜单项。

方法索引

addItemListener(ItemListener)

添加指定的项监听者，接收该复选框菜单项的项事件。

addNotify()

创建该复选框项的同级件。

getSelectedObjects()

返回一个包含复选框菜单项标签的数组 ( 长度为 1 ) ，若该复选框未选中，则返回 null 。

getState()

确定该复选框菜单项的状态为“开”还是“关”。

paramString()

返回表示该复选框菜单项状态的参数字符串。

processEvent(AWTEvent)

处理该复选框菜单项上的事件。

processItemEvent(ItemEvent)

通过将项事件分配给任意已注册的 ItemListener 对象，来处理发生在该复选框菜单项上的项事件。

removeItemListener(ItemListener)

删除指定的项监听者，使其不再接收该复选框菜单项的项事件。

setState(boolean)

将该复选框菜单项设置为指定的状态。

构造子

 public CheckboxMenuItem()

创建一个带空标签的复选框菜单项。菜单项的状态初始设为“关”。

 public CheckboxMenuItem(String label)

用指定的标签创建一个复选框菜单项。菜单项的状态初始设为“关”。

参数：

label - 复选框菜单项的字符串标签，或为 null 表示不带标签的菜单项。

 public CheckboxMenuItem(String label,
                 boolean state)

用指定的标签和状态创建一个复选框菜单项。

参数：

label - 按钮的标签。

state - 菜单项的初始状态，其中 true 表示“开”，false 表示“关”。

方法

 public void addNotify()

创建该复选框项的同级件。该同级件允许在不改变复选框项的功能的情况下改变其外观。大多数应用不直接调用该方法。

覆盖：

类 MenuItem 中的 addNotify

参见：

createCheckboxMenuItem, getToolkit

 public boolean getState()

确定该复选框菜单项的状态为“开”还是“关”。

返回值：

该复选框菜单项的状态，其中 true 表示“开”， false 表示“关”。

参见：

setState

 public synchronized void setState(boolean b)

将这个复选框菜单项设置为指定的状态。布尔值 true 表示“开”，false 表示“关”。

参数：

b - 表示该复选框菜单项状态的布尔值。

参见：

getState

 public synchronized Object[] getSelectedObjects()

返回一个包含复选框菜单项标签的数组 ( 长度为 1 ) ，若该复选框未选中，则返回 null 。

参见：

ItemSelectable

 public synchronized void addItemListener(ItemListener l)

添加指定的项监听者，接收该复选框菜单项的项事件。

参数：

l - 项监听者。

参见：

ItemEvent, ItemListener, removeItemListener

 public synchronized void removeItemListener(ItemListener l)

删除指定的项监听者，使其不再接收该复选框菜单项的项事件。

参数：

l - 项监听者。

参见：

ItemEvent, ItemListener, addItemListener

 protected void processEvent(AWTEvent e)

处理该复选框菜单项上的事件。若事件是 ItemEvent 的一个实例，该方法调用 processItemEvent 方法。若该事件不是一个项事件，则调用其父类的 processEvent 方法。

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

参数：

e - 事件

覆盖：

类 MenuItem 中的 processEvent

参见：

ItemEvent, processItemEvent

 protected void processItemEvent(ItemEvent e)

通过将项事件分配给任意已注册的 ItemListener 对象，来处理发生在该复选框菜单项上的项事件。

除非这个菜单项可以启用项事件，否则不能调用此方法。当下列条件之一发生时，可以启用项事件：

• 通过 addItemListener 方法，注册一个 ItemListener 对象。
• 通过 enableEvents 方法，使项事件可以启用。

参数：

e - 项事件。

参见：

ItemEvent, ItemListener, addItemListener, enableEvents

 public String paramString()

返回表示该复选框菜单项状态的参数字符串。该字符串对调试有用。

返回值：

这个复选框菜单项的参数字符串。

覆盖：

类 MenuItem 中的 paramString