javax.swing
类 JCheckBoxMenuItem

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.AbstractButton
                  javax.swing.JMenuItem
                      javax.swing.JCheckBoxMenuItem

所有已实现的接口：

ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible, MenuElement, SwingConstants

public class JCheckBoxMenuItem
extends JMenuItem
implements SwingConstants, Accessible

可以被选定或取消选定的菜单项。如果被选定，菜单项的旁边通常会出现一个复选标记。如果未被选定或被取消选定，菜单项的旁边就没有复选标记。像常规菜单项一样，复选框菜单项可以有与之关联的文本或图标，或者二者兼而有之。

isSelected/setSelected 或 getState/setState 都可以用来确定/指定菜单项的选择状态。首选方法是 isSelected 和 setSelected，它们可用于所有菜单和按钮。getState 和 setState 方法用于与其他组件集的兼容性。

通过 Action 可配置按钮，并进行某种程度的控制。将 Action 用于菜单项具有许多直接配置菜单项所不及的优点。有关更多详细信息，请参阅支持 Action 的 Swing 组件，可在 The Java Tutorial 中的 How to Use Actions 一节找到更多信息。

有关使用复选框菜单项的更多信息和示例，请参阅 The Java Tutorial 中的 How to Use Menus 一节。

警告： Swing 不是线程安全的。有关更多信息，请参阅 Swing's Threading Policy。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

JCheckBoxMenuItem

public JCheckBoxMenuItem()

创建一个没有设置文本或图标的、最初未选定的复选框菜单项。

JCheckBoxMenuItem

public JCheckBoxMenuItem(Icon icon)

创建有一个带图标的、最初未被选定的复选框菜单项。

参数：

icon - CheckBoxMenuItem 的图标。

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text)

创建一个带文本的、最初未被选定的复选框菜单项。

参数：

text - CheckBoxMenuItem 的文本

JCheckBoxMenuItem

public JCheckBoxMenuItem(Action a)

创建一个从所提供的 Action 中获取其属性的菜单项。

从以下版本开始：

1.3

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         Icon icon)

创建带有指定文本和图标的、最初未被选定的复选框菜单项。

参数：

text - CheckBoxMenuItem 的文本

icon - CheckBoxMenuItem 的图标

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         boolean b)

创建带有指定文本和选择状态的复选框菜单项。

参数：

text - 复选框菜单项的文本

b - 复选框菜单项的选定状态

JCheckBoxMenuItem

public JCheckBoxMenuItem(String text,
                         Icon icon,
                         boolean b)

创建带有指定文本、图标和选择状态的复选框菜单项。

参数：

text - 复选框菜单项的文本

icon - 复选框菜单项的图标

b - 复选框菜单项的选定状态

getUIClassID

public String getUIClassID()

返回呈现此组件的 L&F 类的名称。

覆盖：

类 JMenuItem 中的 getUIClassID

返回：

"CheckBoxMenuItemUI"

另请参见：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getState

public boolean getState()

返回菜单项的选定状态。此方法仅用于 AWT 兼容性。新代码应该使用 isSelected() 。

返回：

如果该项被选定，则返回 true

setState

public void setState(boolean b)

设置该项的选定状态。此方法仅用于 AWT 兼容性。新代码应该使用 setSelected() 。

参数：

b - 指示该项选定状态的 boolean 值，其中 true = 选定

getSelectedObjects

public Object[] getSelectedObjects()

返回包含复选框菜单项标签的数组 (length 1)，如果没有选定复选框，则返回 null。

指定者：

接口 ItemSelectable 中的 getSelectedObjects

覆盖：

类 AbstractButton 中的 getSelectedObjects

返回：

如果该项被选定，则返回包含一个 Object（菜单项的文本）的数组，否则返回 null

paramString

protected String paramString()

返回此 JCheckBoxMenuItem 的字符串表示形式。此方法仅在进行调试时使用，对于各个实现，所返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

覆盖：

类 JMenuItem 中的 paramString

返回：

此 JCheckBoxMenuItem 的字符串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()

获得与此 JCheckBoxMenuItem 关联的 AccessibleContext。对于 JCheckBoxMenuItems，AccessibleContext 采用 AccessibleJCheckBoxMenuItem 的形式。如有必要，可创建一个新的 AccessibleJCheckBoxMenuItem 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

覆盖：

类 JMenuItem 中的 getAccessibleContext

返回：

一个 AccessibleJCheckBoxMenuItem，它充当此 AccessibleJCheckBoxMenuItem 的 AccessibleContext

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。