ButtonGroup (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.swing
类 ButtonGroup

java.lang.Object
  javax.swing.ButtonGroup

所有已实现的接口：: Serializable

public class ButtonGroup
extends Object
implements Serializable
extends Object
implements Serializable

此类用于为一组按钮创建一个多斥（multiple-exclusion）作用域。使用相同的 ButtonGroup 对象创建一组按钮意味着“开启”其中一个按钮时，将关闭组中的其他所有按钮。

可将 ButtonGroup 用于任何从 AbstractButton 继承的对象组。通常，按钮组包含 JRadioButton、JRadioButtonMenuItem 或 JToggleButton 的实例。但将 JButton 或 JMenuItem 的实例放入按钮组中并没有什么意义，因为 JButton 和 JMenuItem 不实现选择状态。

最初，组中的所有按钮都未被选择。一旦选择了任何按钮，该按钮在组中将总是选择状态。无法以编程方式“关闭”一个按钮以清除按钮组。要显示“未选择”的按钮，则需要将一个不可见的单选钮添加到组中，然后以编程方式选择该按钮，以关闭所有已显示的单选钮。例如，可以激活带标签 "none" 的普通按钮来选择不可见的单选钮。

有关使用按钮组的示例和更多信息，请参阅《The Java Tutorial》中的 How to Radio Buttons 一节。

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

字段摘要

protected Vector<AbstractButton> buttons


构造方法摘要

ButtonGroup()
          创建一个新的 ButtonGroup。

方法摘要

void add(AbstractButton b)
          将按钮添加到组中。

int getButtonCount()
          返回组中的按钮数。

Enumeration<AbstractButton> getElements()
          返回此按钮组中的所有按钮。

ButtonModel getSelection()
          返回选择按钮的模型。

boolean isSelected(ButtonModel m)
          返回对是否已选择一个 ButtonModel 的判断。

void remove(AbstractButton b)
          从组中移除按钮。

void setSelected(ButtonModel m, boolean b)
          为 ButtonModel 设置选择值。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段摘要
`protected Vector<AbstractButton>`	`buttons`

构造方法摘要
`ButtonGroup()` 创建一个新的 `ButtonGroup`。

方法摘要
`void`	`add(AbstractButton b)` 将按钮添加到组中。
`int`	`getButtonCount()` 返回组中的按钮数。
`Enumeration<AbstractButton>`	`getElements()` 返回此按钮组中的所有按钮。
`ButtonModel`	`getSelection()` 返回选择按钮的模型。
`boolean`	`isSelected(ButtonModel m)` 返回对是否已选择一个 `ButtonModel` 的判断。
`void`	`remove(AbstractButton b)` 从组中移除按钮。
`void`	`setSelected(ButtonModel m, boolean b)` 为 `ButtonModel` 设置选择值。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

字段详细信息

buttons

protected Vector<AbstractButton> buttons

构造方法详细信息

ButtonGroup

public ButtonGroup()

创建一个新的 ButtonGroup。

方法详细信息

add

public void add(AbstractButton b)

将按钮添加到组中。

参数：: b - 要添加的按钮

remove

public void remove(AbstractButton b)

从组中移除按钮。

参数：: b - 要移除的按钮

getElements

public Enumeration<AbstractButton> getElements()

返回此按钮组中的所有按钮。

返回：: 此组中的按钮的 Enumeration

getSelection

public ButtonModel getSelection()

返回选择按钮的模型。

返回：: 选择的按钮模型

setSelected

public void setSelected(ButtonModel m,
                        boolean b)

为 ButtonModel 设置选择值。一次只能选择组中的一个按钮。

参数：: m - ButtonModel; b - 如果此按钮被选择，则该参数为 true，否则为 false

isSelected

public boolean isSelected(ButtonModel m)

返回对是否已选择一个 ButtonModel 的判断。

返回：: 如果选择了按钮，则返回 true；否则返回 false

getButtonCount

public int getButtonCount()

返回组中的按钮数。

返回：: 按钮计数
从以下版本开始：: 1.3

概述