- java.lang.Object
-
- java.awt.MenuComponent
-
- java.awt.MenuItem
-
- java.awt.CheckboxMenuItem
-
- 实现的所有接口
-
ItemSelectable
,Serializable
,Accessible
public class CheckboxMenuItem extends MenuItem implements ItemSelectable, Accessible
此类表示可以包含在菜单中的复选框。 选择菜单中的复选框会将其状态从“开”更改为“关”或从“关”更改为“开”。下图描绘了一个包含
CheckBoxMenuItem
实例的CheckBoxMenuItem
:标记为
Check
的项目显示处于“关闭”状态的复选框菜单项。选中复选框菜单项后,AWT会向项目发送项目事件。 由于事件是
ItemEvent
的实例,因此processEvent
方法检查事件并将其传递给processItemEvent
。 后一种方法将事件重定向到已注册对此菜单项生成的项事件感兴趣的任何ItemListener
对象。- 从以下版本开始:
- 1.0
- 另请参见:
-
ItemEvent
,ItemListener
, Serialized Form
-
-
嵌套类汇总
嵌套类 变量和类型 类 描述 protected class
CheckboxMenuItem.AccessibleAWTCheckboxMenuItem
CheckboxMenuItem的内部类用于为可访问性提供默认支持。-
嵌套类/接口声明在类 java.awt.MenuItem
MenuItem.AccessibleAWTMenuItem
-
嵌套类/接口声明在类 java.awt.MenuComponent
MenuComponent.AccessibleAWTMenuComponent
-
-
构造方法摘要
构造方法 构造器 描述 CheckboxMenuItem()
创建一个带有空标签的复选框菜单项。CheckboxMenuItem(String label)
创建具有指定标签的复选框菜单项。CheckboxMenuItem(String label, boolean state)
创建具有指定标签和状态的复选框菜单项。
-
方法摘要
所有方法 实例方法 具体的方法 变量和类型 方法 描述 void
addItemListener(ItemListener l)
添加指定的项侦听器以从此复选框菜单项接收项事件。void
addNotify()
创建复选框项的对等项。AccessibleContext
getAccessibleContext()
获取与此CheckboxMenuItem关联的AccessibleContext。ItemListener[]
getItemListeners()
返回在此复选框menuitem上注册的所有项侦听器的数组。<T extends EventListener>
T[]getListeners(类<T> listenerType)
返回当前注册的所有对象的数组FooListener
在这个SCheckboxMenuItem
。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)
将此复选框菜单项设置为指定的状态。-
声明方法的类 java.awt.MenuItem
addActionListener, deleteShortcut, disable, disableEvents, enable, enable, enableEvents, getActionCommand, getActionListeners, getLabel, getShortcut, isEnabled, processActionEvent, removeActionListener, setActionCommand, setEnabled, setLabel, setShortcut
-
声明方法的类 java.awt.MenuComponent
dispatchEvent, getFont, getName, getParent, getTreeLock, postEvent, removeNotify, setFont, setName, toString
-
-
-
-
构造方法详细信息
-
CheckboxMenuItem
public CheckboxMenuItem() throws HeadlessException
创建一个带有空标签的复选框菜单项。 项目的状态最初设置为“关闭”。- 异常
-
HeadlessException
- 如果GraphicsEnvironment.isHeadless()返回true - 从以下版本开始:
- 1.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
表示“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
-
addItemListener
public void addItemListener(ItemListener l)
添加指定的项侦听器以从此复选框菜单项接收项事件。 项目事件是为响应用户操作而发送的,但不响应对setState()的调用。 如果l为null,则不抛出任何异常并且不执行任何操作。有关AWT螺纹模型的详细信息,请参阅AWT Threading Issues 。
- Specified by:
-
addItemListener
在界面ItemSelectable
- 参数
-
l
- 项侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
removeItemListener(java.awt.event.ItemListener)
,getItemListeners()
,setState(boolean)
,ItemEvent
,ItemListener
-
removeItemListener
public void removeItemListener(ItemListener l)
- Specified by:
-
removeItemListener
在界面ItemSelectable
- 参数
-
l
- 项侦听器 - 从以下版本开始:
- 1.1
- 另请参见:
-
addItemListener(java.awt.event.ItemListener)
,getItemListeners()
,ItemEvent
,ItemListener
-
getItemListeners
public ItemListener[] getItemListeners()
返回在此复选框menuitem上注册的所有项侦听器的数组。- 结果
-
所有这个复选框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
在这个SCheckboxMenuItem
。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
-
-