- 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
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/swing/ButtonGroup.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.