Using the JFC/Swing Packages |
Radio buttons are groups of buttons in which only one button at a time can be selected. The Swing release supports radio buttons with theJRadioButton
andButtonGroup
classes.Because
JRadioButton
inherits fromAbstractButton
, Swing radio buttons have all the usual button characteristics, as discussed in How to Use Buttons. For example, you can specify the text (if any) and image in a radio button.Here is a picture of an application that has two radio buttons:
[We'll try to make the example more interesting...]
Try this:
- Compile and run the application. The source file is
RadioButtonDemo.java
.
See Getting Started with Swing if you need help.- Click Button 2.
Button 2 becomes selected, which makes Button 1 become unselected.- Look at the messages displayed at the standard output.
This application registers a listener for each kind of event a button can send -- action, change, and item. Each time it receives an event, the application displays a message describing the event.- Click Button 2 again, and look at the messages displayed at the standard output.
Often, the only event handler a radio button needs is an action listener. You can use an item listener instead if you're simply monitoring state changes, rather than acting on them. You don't need to implement a change listener unless your program needs to know every time the button's appearance changes. [check all this]
Note: If you have a strong opinion about what events should be generated by radio buttons, please let us know. For example, a radio button currently generates an action event even when the user clicks an already selected button. It probably shouldn't.
Below is the code from
RadioButtonDemo.java
that creates the radio buttons in the previous example and reacts to clicks.See How to Use Buttons for information on the//In initialization code: // Create the buttons. JRadioButton firstButton = new JRadioButton(first); firstButton.setKeyAccelerator('1'); firstButton.setActionCommand(first); firstButton.setSelected(true); JRadioButton secondButton = new JRadioButton(second); secondButton.setKeyAccelerator('2'); secondButton.setActionCommand(second); // Group the radio buttons. ButtonGroup group = new ButtonGroup(); group.add(firstButton); group.add(secondButton); // Register a listener for the radio buttons. RadioListener myListener = new RadioListener(); firstButton.addActionListener(myListener); firstButton.addChangeListener(myListener); firstButton.addItemListener(myListener); secondButton.addActionListener(myListener); secondButton.addChangeListener(myListener); secondButton.addItemListener(myListener); . . . class RadioListener implements ActionListener, //only one event type needed ChangeListener, //for curiosity only ItemListener { //for curiosity only public void actionPerformed(ActionEvent e) { String factoryName = null; System.out.print("ActionEvent received: "); if (e.getActionCommand() == first) { System.out.println(first + " pressed."); } else { System.out.println(second + " pressed."); } } public void itemStateChanged(ItemEvent e) { System.out.println("ItemEvent received: " + e.getItem() + " is now " + ((e.getStateChange() == ItemEvent.SELECTED)? "selected.":"unselected")); } public void stateChanged(ChangeEvent e) { System.out.println("ChangeEvent received from: " + e.getSource()); } }AbstractButton
API thatJRadioButton
inherits. The only API defined byJRadioButton
that you're likely to use are the constructors.JRadioButton
defines seven constructors:
JRadioButton(String)
JRadioButton(String, boolean)
JRadioButton(Icon)
JRadioButton(Icon, boolean)
JRadioButton(String, Icon)
JRadioButton(String, Icon, boolean)
JRadioButton()
The arguments are straightforward:
String
- Specifies the text that the radio button should display.
Icon
- Specifies the image that the radio button should display. Unless you specify an image, the images defined by the look-and-feel are used.
boolean
- Specifies whether the radio button is selected. By default, it's
false
(not selected).For each group of radio buttons, you need to create a
ButtonGroup
instance and add each radio button to it. TheButtonGroup
ensures that exactly one button in the group is selected. [I suspect the group can be created with no button selected.] Here are theButtonGroup
methods and constructors you're likely to use:
ButtonGroup()
- Creates an instance of
ButtonGroup
.add(AbstractButton)
- Adds the specified button to the group.
remove(AbstractButton)
- Removes the specified button from the group.
Using the JFC/Swing Packages |