1 /* JToggleButton.java --
2 Copyright (C) 2002, 2004, 2005 Free Software Foundation, Inc.
4 This file is part of GNU Classpath.
6 GNU Classpath is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2, or (at your option)
11 GNU Classpath is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GNU Classpath; see the file COPYING. If not, write to the
18 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21 Linking this library statically or dynamically with other modules is
22 making a combined work based on this library. Thus, the terms and
23 conditions of the GNU General Public License cover the whole
26 As a special exception, the copyright holders of this library give you
27 permission to link this library with independent modules to produce an
28 executable, regardless of the license terms of these independent
29 modules, and to copy and distribute the resulting executable under
30 terms of your choice, provided that you also meet, for each linked
31 independent module, the terms and conditions of the license of that
32 module. An independent module is a module which is not derived from
33 or based on this library. If you modify this library, you may extend
34 this exception to your version of the library, but you are not
35 obligated to do so. If you do not wish to do so, delete this
36 exception statement from your version. */
41 import java
.awt
.event
.ActionEvent
;
42 import java
.awt
.event
.ItemEvent
;
43 import java
.awt
.event
.ItemListener
;
45 import javax
.accessibility
.Accessible
;
46 import javax
.accessibility
.AccessibleContext
;
47 import javax
.accessibility
.AccessibleRole
;
48 import javax
.accessibility
.AccessibleState
;
49 import javax
.swing
.plaf
.ButtonUI
;
52 * The <code>JToggleButton</code> component provides a stateful button,
53 * which can be either selected or unselected. This provides the basis
54 * for the implementations of radio buttons (<code>JRadioButton</code>)
55 * and check boxes (<code>JCheckBox</code>).
57 * @author Michael Koch (konqueror@gmx.de)
58 * @author Graydon Hoare (graydon@redhat.com)
59 * @author Andrew John Hughes (gnu_andrew@member.fsf.org)
64 public class JToggleButton
extends AbstractButton
implements Accessible
67 * This class provides accessibility support for the toggle button.
69 protected class AccessibleJToggleButton
70 extends AccessibleAbstractButton
71 implements ItemListener
73 private static final long serialVersionUID
= -8652952712161229225L;
76 * Constructor for the accessible toggle button.
78 public AccessibleJToggleButton()
81 /* Register the accessible toggle button as a listener for item events */
82 addItemListener(this);
86 * Returns the accessible role for the toggle button.
88 * @return An instance of <code>AccessibleRole</code>, describing
89 * the role of the toggle button.
91 public AccessibleRole
getAccessibleRole()
93 return AccessibleRole
.TOGGLE_BUTTON
;
97 * Monitors the toggle button for state changes and fires accessible
98 * property change events when they occur.
100 * @param event the event that occurred.
102 public void itemStateChanged(ItemEvent event
)
104 /* Fire a state property change event as the button's state has changed */
105 if (event
.getStateChange() == ItemEvent
.SELECTED
)
107 /* State has changed from unselected (null) to selected */
108 firePropertyChange(ACCESSIBLE_STATE_PROPERTY
, null, AccessibleState
.SELECTED
);
112 /* State has changed from selected to unselected (null) */
113 firePropertyChange(ACCESSIBLE_STATE_PROPERTY
, AccessibleState
.ENABLED
, null);
120 * The model handles the storage and maintenance of the state of
121 * the toggle button. This follows the same paradigm (the MVC
122 * or Model-View-Controller design pattern) employed by
123 * other Swing components, where the data associated with a component
124 * is stored separately from the display aspects.
126 public static class ToggleButtonModel
extends DefaultButtonModel
129 * Compatible with Sun's JDK.
131 private static final long serialVersionUID
= -1589950750899943974L;
134 * Sets the pressed state of the button. The selected state
135 * of the button also changes follwing the button being pressed.
137 * @param p true if the button is pressed down.
139 public void setPressed(boolean p
)
141 // cannot change PRESSED state unless button is enabled
145 // if this call does not represent a CHANGE in state, then return
146 if ((p
&& isPressed()) || (!p
&& !isPressed()))
149 // The JDK first fires events in the following order:
150 // 1. ChangeEvent for selected
151 // 2. ChangeEvent for pressed
155 // setPressed(false) == mouse release on us,
156 // if we were armed, we flip the selected state.
159 setSelected(! isSelected());
164 stateMask
= stateMask
| PRESSED
;
166 stateMask
= stateMask
& (~PRESSED
);
168 // notify interested ChangeListeners
173 fireActionPerformed(new ActionEvent(this,
174 ActionEvent
.ACTION_PERFORMED
,
180 * Checks if the button is selected.
182 * @returns true if the button is selected
184 public boolean isSelected()
186 return super.isSelected();
190 * Sets the selected state of the button.
192 * @param b true if button is selected
194 public void setSelected(boolean b
)
196 super.setSelected(b
);
201 * Compatible with Sun's JDK.
203 private static final long serialVersionUID
= -3128248873429850443L;
206 * Constructs an unselected toggle button with no text or icon.
208 public JToggleButton()
210 this(null, null, false);
214 * Constructs a toggle button using the labelling, state
215 * and icon specified by the supplied action.
217 * @param a the action to use to define the properties of the button.
219 public JToggleButton(Action a
)
226 * Constructs an unselected toggle button with the supplied icon
229 * @param icon the icon to use.
231 public JToggleButton(Icon icon
)
233 this(null, icon
, false);
237 * Constructs a toggle button with the supplied icon and state.
239 * @param icon the icon to use.
240 * @param selected if true, the toggle button is initially in the
241 * selected state. Otherwise, the button is unselected.
243 public JToggleButton(Icon icon
, boolean selected
)
245 this(null, icon
, selected
);
249 * Constructs an unselected toggle button using the supplied text
252 * @param text the text to use.
254 public JToggleButton(String text
)
256 this(text
, null, false);
260 * Constructs a toggle button with the supplied text and state.
262 * @param text the text to use.
263 * @param selected if true, the toggle button is initially in the
264 * selected state. Otherwise, the button is unselected.
266 public JToggleButton(String text
, boolean selected
)
268 this(text
, null, selected
);
272 * Constructs an unselected toggle button with the supplied text
275 * @param text the text to use.
276 * @param icon the icon to use.
278 public JToggleButton(String text
, Icon icon
)
280 this(text
, icon
, false);
284 * Constructs a toggle button with the supplied text, icon and state.
286 * @param text the text to use.
287 * @param icon the icon to use.
288 * @param selected if true, the toggle button is initially in the
289 * selected state. Otherwise, the button is unselected.
291 public JToggleButton (String text
, Icon icon
, boolean selected
)
296 setModel(new ToggleButtonModel());
297 model
.setSelected(selected
);
298 setAlignmentX(LEFT_ALIGNMENT
);
302 * Gets the AccessibleContext associated with this <code>JToggleButton</code>.
303 * The context is created, if necessary.
305 * @return the associated context
307 public AccessibleContext
getAccessibleContext()
309 /* Create the context if this is the first request */
310 if (accessibleContext
== null)
312 /* Create the context */
313 accessibleContext
= new AccessibleJToggleButton();
315 return accessibleContext
;
319 * Returns a string that specifies the name of the Look and Feel
320 * class that renders this component.
322 * @return The Look and Feel UI class in <code>String</code> form.
324 public String
getUIClassID()
326 return "ToggleButtonUI";
330 * Returns a textual representation of this component for debugging.
331 * Users should not depend on anything as regards the content or formatting
332 * of this string, except for the fact that the returned string may never be
335 * @return the component in <code>String</code> form for debugging.
337 protected String
paramString()
339 return super.paramString();
343 * This method resets the toggle button's UI delegate to the default UI for
344 * the current look and feel.
346 public void updateUI()
348 setUI((ButtonUI
)UIManager
.getUI(this));