- /*
- * @(#)ButtonGroup.java 1.23 01/11/29
- *
- * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
- package javax.swing;
-
- import java.awt.event.*;
- import java.util.Vector;
- import java.util.Enumeration;
- import java.io.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.
- * <p>
- * 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.
- * <p>
- * <strong>Warning:</strong>
- * 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.
- *
- * @version 1.23 11/29/01
- * @author Jeff Dinkins
- */
- public class ButtonGroup implements Serializable {
-
- // the list of buttons participating in this group
- protected Vector buttons = new Vector();
-
- /**
- * The current choice.
- */
- ButtonModel selection = null;
-
- /**
- * Creates a new ButtonGroup.
- */
- public ButtonGroup() {}
-
- /**
- * Adds the button to the group.
- */
- public void add(AbstractButton b) {
- if(b == null) {
- return;
- }
- buttons.addElement(b);
- if(selection == null && b.isSelected()) {
- selection = b.getModel();
- }
- b.getModel().setGroup(this);
- }
-
- /**
- * Removes the button from the group.
- */
- public void remove(AbstractButton b) {
- if(b == null) {
- return;
- }
- buttons.removeElement(b);
- if(b.getModel() == selection) {
- selection = null;
- }
- b.getModel().setGroup(null);
- }
-
- /**
- * Return all the buttons that are participating in
- * this group.
- */
- public Enumeration getElements() {
- return buttons.elements();
- }
-
- /**
- * Return the selected button model.
- */
- public ButtonModel getSelection() {
- return selection;
- }
-
- /**
- * Sets the selected value for the button.
- */
- public void setSelected(ButtonModel m, boolean b) {
- if(b && m != selection) {
- ButtonModel oldSelection = selection;
- selection = m;
- if(oldSelection != null) {
- oldSelection.setSelected(false);
- }
- }
- }
-
- /**
- * Returns the selected value for the button.
- */
- public boolean isSelected(ButtonModel m) {
- return (m == selection);
- }
-
- }