Java(TM) 2 Platform, Standard Edition, v1.2.2 API Specification: Class ButtonGroup - JDK 5 Documentation v1.2.2, Java 2 SDK 英文文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Standard Edition

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.swing
Class ButtonGroup

java.lang.Object
  |
  +--javax.swing.ButtonGroup

public class ButtonGroup
extends Object
implements Serializable

This class is used to create a multiple-exclusion scope for a set of buttons. Creating a set of buttons with the same ButtonGroup object means that turning "on" one of those buttons turns off all other buttons in the group. A ButtonGroup can be used with sets of JButton, JRadioButton, or JRadioButtonMenuItem objects.

Initially, all buttons in the group are unselected. Once any button is selected, one button is always selected in the group. There is no way to turn a button programmatically to "off", in order to clear the button group. To give the appearance of "none selected", add an invisible radio button to the group and then programmatically select that button to turn off all the displayed radio buttons. For example, a normal button with the label "none" could be wired to select the invisible radio button.

Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. A future release of Swing will provide support for long term persistence.

See Also:: Serialized Form

Field Summary

protected Vector buttons


Constructor Summary

ButtonGroup()
          Creates a new ButtonGroup.

Method Summary

void add(AbstractButton b)
          Adds the button to the group.

Enumeration getElements()
          Return all the buttons that are participating in this group.

ButtonModel getSelection()
          Return the selected button model.

boolean isSelected(ButtonModel m)
          Returns the selected value for the button.

void remove(AbstractButton b)
          Removes the button from the group.

void setSelected(ButtonModel m, boolean b)
          Sets the selected value for the button.

Methods inherited from class java.lang.Object

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

Field Detail

buttons

protected Vector buttons

Constructor Detail

ButtonGroup

public ButtonGroup()

Creates a new ButtonGroup.

Method Detail

add

public void add(AbstractButton b)

Adds the button to the group.

remove

public void remove(AbstractButton b)

Removes the button from the group.

getElements

public Enumeration getElements()

Return all the buttons that are participating in this group.

getSelection

public ButtonModel getSelection()

Return the selected button model.

setSelected

public void setSelected(ButtonModel m,
                        boolean b)

Sets the selected value for the button.

isSelected

public boolean isSelected(ButtonModel m)

Returns the selected value for the button.