Java java.awt 类 CheckboxMenuItem（JDK5）

所有类

java.awt
类 CheckboxMenuItem

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

所有已实现的接口：

ItemSelectable, Serializable, Accessible

public class CheckboxMenuItem
   
   
   
   
   
extends MenuItem
   
   
   
   
   
   
   
   
   
   
implements ItemSelectable, Accessible
   
   
   
   
   

此类表示一个可包括在菜单中的复选框。选择菜单中的复选框可以将其状态从 "on" 更改为 "off" 或者从 "off" 更改为 "on"。

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

Check 项显示了一个处于 "off" 状态的复选框菜单项。

当选中了一个复选框菜单项时，AWT 将一个项事件发送到该项。因为该事件是 ItemEvent 的一个实例，所以 processEvent 方法检查该事件，同时将它传递给 processItemEvent。后一种方法将该事件重定向到任何为关注此菜单项生成的项事件而注册的 ItemListener 对象。

从以下版本开始：

JDK1.0

另请参见：

ItemEvent, ItemListener, 序列化表格

CheckboxMenuItem

public CheckboxMenuItem()
                 throws HeadlessException

创建一个带空标签的复选框菜单项。菜单项的状态初始设置为 "off"。

抛出：

HeadlessException - 如果 GraphicsEnvironment.isHeadless() 返回 true

从以下版本开始：

JDK1.1

另请参见：

GraphicsEnvironment.isHeadless()

CheckboxMenuItem

public CheckboxMenuItem(String label)
                 throws HeadlessException

创建一个具有指定标签的复选框菜单项。菜单项的状态初始设置为 "off"。

参数：

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

从以下版本开始：

JDK1.1

另请参见：

GraphicsEnvironment.isHeadless()

addNotify

public void addNotify()

创建复选框项的同位体。此同位体允许更改复选框外观，而不更改其功能。大多数应用程序并不直接调用此方法。

覆盖：

类 MenuItem 中的 addNotify

另请参见：

Toolkit.createCheckboxMenuItem(java.awt.CheckboxMenuItem), Component.getToolkit()

getState

public boolean getState()

确定此复选框菜单项的状态是 "on" 还是 "off"。

返回：

复选框菜单项的状态，其中，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。

指定者：

接口 ItemSelectable 中的 getSelectedObjects

另请参见：

ItemSelectable

addItemListener

public void addItemListener(ItemListener l)

添加指定的项侦听器，以接收来自此复选框菜单项的项事件。发送项事件，以响应用户操作，但不响应对 setState() 的调用。如果 l 为 null，则不抛出任何异常，也不执行任何操作。

指定者：

接口 ItemSelectable 中的 addItemListener

参数：

l - 项侦听器

从以下版本开始：

JDK1.1

另请参见：

removeItemListener(java.awt.event.ItemListener), getItemListeners(), setState(boolean), ItemEvent, ItemListener