javax.swing
类 ButtonGroup

java.lang.Object
  javax.swing.ButtonGroup

所有已实现的接口：

Serializable

public class ButtonGroup
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

字段详细信息

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