javax.swing.ButtonGroup

public class javax.swing

ButtonGroup

Java SE 6

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 any set of objects that inherit from AbstractButton. Typically a button group contains instances of JRadioButton, JRadioButtonMenuItem, or JToggleButton. It wouldn't make sense to put an instance of JButton or JMenuItem in a button group because JButton and JMenuItem don't implement the selected state.

Initially, all buttons in the group are unselected.

For examples and further information on using button groups see How to Use Radio Buttons, a section in The Java Tutorial.

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. As of 1.4, support for long term storage of all JavaBeans^TM has been added to the java.beans package. Please see java.beans.XMLEncoder.

version 1.39 11/17/05

Fields

protected Vector

buttons

Constructors

public

ButtonGroup()
Creates a new ButtonGroup.

Methods

public void

add(AbstractButton b) Details

Adds the button to the group.

b	the button to be added

public void

clearSelection() Details

Clears the selection such that none of the buttons in the ButtonGroup are selected.

since

1.6

public void

remove(AbstractButton b) Details

Removes the button from the group.

b	the button to be removed

Properties

public int

getButtonCount() Details

Returns the number of buttons in the group.

return	the button count
since	1.3

public Enumeration

getElements() Details

Returns all the buttons that are participating in this group.

return an Enumeration of the buttons in this group

public void

setSelected(ButtonModel m, boolean b) Details

Sets the selected value for the ButtonModel. Only one button in the group may be selected at a time.

m	the `ButtonModel`
b	`true` if this button is to be selected, otherwise `false`

public boolean

isSelected(ButtonModel m) Details

Returns whether a ButtonModel is selected.

return true if the button is selected, otherwise returns false

public ButtonModel

getSelection() Details

Returns the model of the selected button.

return

the selected button model

About DocWeb · Bundles · Export · Export All

Top 10 · Statistics · Login

About Sun · Contact · Privacy · Terms of Use · Trademarks

Java SE 6

· Copyright © 1994-2009 Sun Microsystems, Inc.
All rights reserved. Use is subject to license terms