- java.lang.Object
-
- javax.swing.ButtonGroup
-
- All Implemented Interfaces:
- Serializable
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 sameButtonGroup
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 fromAbstractButton
. Typically a button group contains instances ofJRadioButton
,JRadioButtonMenuItem
, orJToggleButton
. It wouldn't make sense to put an instance ofJButton
orJMenuItem
in a button group becauseJButton
andJMenuItem
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 JavaBeansTM has been added to the
java.beans
package. Please seeXMLEncoder
.
-
-
Field Summary
Fields Modifier and Type Field and Description protected Vector<AbstractButton>
buttons
-
Constructor Summary
Constructors Constructor and Description ButtonGroup()
Creates a newButtonGroup
.
-
Method Summary
Methods Modifier and Type Method and Description void
add(AbstractButton b)
Adds the button to the group.void
clearSelection()
Clears the selection such that none of the buttons in theButtonGroup
are selected.int
getButtonCount()
Returns the number of buttons in the group.Enumeration<AbstractButton>
getElements()
Returns all the buttons that are participating in this group.ButtonModel
getSelection()
Returns the model of the selected button.boolean
isSelected(ButtonModel m)
Returns whether aButtonModel
is selected.void
remove(AbstractButton b)
Removes the button from the group.void
setSelected(ButtonModel m, boolean b)
Sets the selected value for theButtonModel
.
-
-
-
Field Detail
-
buttons
protected Vector<AbstractButton> buttons
-
-
Method Detail
-
add
public void add(AbstractButton b)
Adds the button to the group.- Parameters:
b
- the button to be added
-
remove
public void remove(AbstractButton b)
Removes the button from the group.- Parameters:
b
- the button to be removed
-
clearSelection
public void clearSelection()
Clears the selection such that none of the buttons in theButtonGroup
are selected.- Since:
- 1.6
-
getElements
public Enumeration<AbstractButton> getElements()
Returns all the buttons that are participating in this group.- Returns:
- an
Enumeration
of the buttons in this group
-
getSelection
public ButtonModel getSelection()
Returns the model of the selected button.- Returns:
- the selected button model
-
setSelected
public void setSelected(ButtonModel m, boolean b)
Sets the selected value for theButtonModel
. Only one button in the group may be selected at a time.- Parameters:
m
- theButtonModel
b
-true
if this button is to be selected, otherwisefalse
-
isSelected
public boolean isSelected(ButtonModel m)
Returns whether aButtonModel
is selected.- Returns:
true
if the button is selected, otherwise returnsfalse
-
getButtonCount
public int getButtonCount()
Returns the number of buttons in the group.- Returns:
- the button count
- Since:
- 1.3
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
22/12/2024 09:49:50 Cette version de la page est en cache (à la date du 22/12/2024 09:49:50) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/swing/ButtonGroup.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.