Java javax.swing 类 ButtonGroup（JDK5）

所有类

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。

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