org.tbee.swing
Class JButtonGroup<T>

java.lang.Object
  javax.swing.ButtonGroup
      org.tbee.swing.JButtonGroup<T>

All Implemented Interfaces:

Serializable

public class JButtonGroup<T>
extends ButtonGroup

Extends javax.swing.ButtonGroup to provide methods that allow working with button references instead of button models. By using bindValue(button, value) or the associated add(button, value) it is possible to relate a value to a button. By using setValue(), getValue() and the value property change event, the buttongroup can be bound to a bean property.

Version:

$Revision: 1.14 $

See Also:

ButtonGroup, Serialized Form

Field Summary

static String	SOURCECODE_VERSION Standard variable for determining version of a class file.
static String	VALUE_PROPERTY_ID

Fields inherited from class javax.swing.ButtonGroup

buttons

Constructor Summary

JButtonGroup()
Creates an empty JButtonGroup

JButtonGroup(AbstractButton... buttons)
Creates a JButtonGroup object from an array of buttons and adds the buttons to the group No button will be selected initially.

Method Summary

void	add(AbstractButton... buttons) Adds an array of buttons to the group
void	add(AbstractButton button) Adds a button to the group
void	add(AbstractButton button, T value) Adds a button to the group
void	addPropertyChangeListener(PropertyChangeListener o)
void	addPropertyChangeListener(String propertyName, PropertyChangeListener o)
void	bindValue(AbstractButton button, T value) store the relation between button and value
boolean	contains(AbstractButton button) Checks whether the group contains the given button
void	firePropertyChange(String name, T before, T after)
void	fireValueChangedIfRequired()
AbstractButton	getButton(ButtonModel model) Returns the AbstractButton whose ButtonModel is given.
List<AbstractButton>	getButtons() Returns the buttons in the group as a List
PropertyChangeListener[]	getPropertyChangeListeners() PropertyChange
PropertyChangeListener[]	getPropertyChangeListeners(String propertyName)
AbstractButton	getSelected() Returns the selected button in the group.
T	getValue()
boolean	isEnabled()
boolean	isSelected(AbstractButton button) Returns whether the button is selected
void	remove(AbstractButton... buttons) Removes all the buttons in the array from the group
void	remove(AbstractButton button) Removes a button from the group
void	removePropertyChangeListener(PropertyChangeListener o)
void	removePropertyChangeListener(String propertyName, PropertyChangeListener o)
void	setEnabled(boolean value) Enabled
void	setSelected(AbstractButton button, boolean selected) Sets the selected button in the group Only one button in the group can be selected
void	setSelected(ButtonModel model, boolean selected) Sets the selected button model in the group
void	setValue(T value) get the value of the selected button
void	unbindValue(AbstractButton button)

Methods inherited from class javax.swing.ButtonGroup

clearSelection, getButtonCount, getElements, getSelection, isSelected

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SOURCECODE_VERSION

public static final String SOURCECODE_VERSION

Standard variable for determining version of a class file.

See Also:

Constant Field Values

VALUE_PROPERTY_ID

public static final String VALUE_PROPERTY_ID

See Also:

Constant Field Values

Constructor Detail

JButtonGroup

public JButtonGroup()

Creates an empty JButtonGroup

JButtonGroup

public JButtonGroup(AbstractButton... buttons)

Creates a JButtonGroup object from an array of buttons and adds the buttons to the group No button will be selected initially.

Parameters:

buttons - an array of AbstractButtons

Method Detail

add

public void add(AbstractButton button)

Adds a button to the group

Overrides:

add in class ButtonGroup

Parameters:

button - an AbstractButton reference

add

public void add(AbstractButton... buttons)

Adds an array of buttons to the group

Parameters:

buttons - an array of AbstractButtons

remove

public void remove(AbstractButton button)

Removes a button from the group

Overrides:

remove in class ButtonGroup

Parameters:

button - the button to be removed

remove

public void remove(AbstractButton... buttons)

Removes all the buttons in the array from the group

Parameters:

buttons - an array of AbstractButtons

setSelected

public void setSelected(AbstractButton button,
                        boolean selected)

Sets the selected button in the group Only one button in the group can be selected

Parameters:

button - an AbstractButton reference

selected - an boolean representing the selection state of the button

setSelected

public void setSelected(ButtonModel model,
                        boolean selected)

Sets the selected button model in the group

Overrides:

setSelected in class ButtonGroup

Parameters:

model - a ButtonModel reference

selected - an boolean representing the selection state of the button

getButton

public AbstractButton getButton(ButtonModel model)

Returns the AbstractButton whose ButtonModel is given. If the model does not belong to a button in the group, returns null.

Parameters:

model - a ButtonModel that should belong to a button in the group

Returns:

an AbstractButton reference whose model is model if the button belongs to the group, nullotherwise

getSelected

public AbstractButton getSelected()

Returns the selected button in the group.

Returns:

a reference to the currently selected button in the group or null if no button is selected

isSelected

public boolean isSelected(AbstractButton button)

Returns whether the button is selected

Parameters:

button - an AbstractButton reference

Returns:

true if the button is selected, false otherwise

getButtons

public List<AbstractButton> getButtons()

Returns the buttons in the group as a List

Returns:

a List containing the buttons in the group, in the order they were added to the group

contains

public boolean contains(AbstractButton button)

Checks whether the group contains the given button

Returns:

true if the button is contained in the group, false otherwise

setEnabled

public void setEnabled(boolean value)

Enabled

Parameters:

value -

isEnabled

public boolean isEnabled()

setValue

public void setValue(T value)

get the value of the selected button

getValue

public T getValue()

fireValueChangedIfRequired

public void fireValueChangedIfRequired()

bindValue

public void bindValue(AbstractButton button,
                      T value)

store the relation between button and value

unbindValue

public void unbindValue(AbstractButton button)

add

public void add(AbstractButton button,
                T value)

Adds a button to the group

Parameters:

button - an AbstractButton reference

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners()

PropertyChange

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener o)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener o)

getPropertyChangeListeners

public PropertyChangeListener[] getPropertyChangeListeners(String propertyName)

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                                      PropertyChangeListener o)

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                         PropertyChangeListener o)

firePropertyChange

public void firePropertyChange(String name,
                               T before,
                               T after)