no.g9.client.component

Class G9ButtonGroup

java.lang.Object

javax.swing.ButtonGroup

no.g9.client.component.G9ButtonGroup

All Implemented Interfaces:

ActionListener, FocusListener, Serializable, EventListener, G9ValueState

public class G9ButtonGroup
extends ButtonGroup
implements FocusListener, G9ValueState, ActionListener

The button group class, used to group radio buttons.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	G9ButtonGroup.ComponentGroup Since the radio button group some times needs to be considered as a Swing component, this class can act on behalf of the radio group.

Field Summary

Fields

Modifier and Type	Field and Description
protected EventListenerList	listenerList List of event listeners
protected EventListenerList	vcListeners list of value changed listeners

Fields inherited from class javax.swing.ButtonGroup

buttons

Constructor Summary

Constructors

Constructor and Description
G9ButtonGroup() Default constructor.

Method Summary

Modifier and Type	Method and Description
void	actionPerformed(ActionEvent e)
void	add(AbstractButton b)
void	addActionListener(ActionListener listener) Adds an action listener to the group of listeners that should get notified when an action event occurs.
void	addFocusListener(FocusListener listener) Adds a focus listener to the list of listeners that should be notified when a focus event occurs.
void	addValueChangedListener(G9ValueChangedListener listener) Adds a change listener to this component.
JComponent	asComponent() Returns a component view of this group
void	clear() Clears the radio button group.
void	display(Object o) Updates the displayed value of the component, without affecting the state of the component.
void	fireActionEvent(ActionEvent e) Fires an action event, notifying any registred listeneres interrested in this type of event.
void	fireFocusEvent(FocusEvent e) Fires a focus event, notifying any registred listeners interrested in this typeof event.
protected void	fireG9ValueChangedEvent(int id, Object oldValue, Object newValue) Fires a g9 value changed event.
void	focusGained(FocusEvent e)
void	focusLost(FocusEvent e)
Object	getInitialValue() Returns the initial displayed value.
boolean	isChanged() Checks if the currently displayed value is the same as the initial value.
boolean	isClear() Check if the radio group is clear, viz.
void	resetState() Forces the currently displayed value to be considered the old value.
void	setInitialValue(Object value) Sets the initial value to be the specified value.
void	updateSelection() Updates initial selected value of this group.

Methods inherited from class javax.swing.ButtonGroup

clearSelection, getButtonCount, getElements, getSelection, isSelected, remove, setSelected

Methods inherited from class java.lang.Object

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

Field Detail

vcListeners

protected EventListenerList vcListeners

list of value changed listeners

listenerList

protected EventListenerList listenerList

List of event listeners

Constructor Detail

G9ButtonGroup

public G9ButtonGroup()

Default constructor.

Method Detail

asComponent

public JComponent asComponent()

Returns a component view of this group

Returns:

a component view of this group

add

public void add(AbstractButton b)

Overrides:

add in class ButtonGroup

focusGained

public void focusGained(FocusEvent e)

Specified by:

focusGained in interface FocusListener

clear

public void clear()

Clears the radio button group. After invoking this method, none of the visible radio buttons are selected.

focusLost

public void focusLost(FocusEvent e)

Specified by:

focusLost in interface FocusListener

addValueChangedListener

public void addValueChangedListener(G9ValueChangedListener listener)

Description copied from interface: G9ValueState

Adds a change listener to this component. The change listener will be notified when a value changed event occurs.

Specified by:

addValueChangedListener in interface G9ValueState

Parameters:

listener - the listener to add

addActionListener

public void addActionListener(ActionListener listener)

Adds an action listener to the group of listeners that should get notified when an action event occurs.

Parameters:

listener - the action listener

addFocusListener

public void addFocusListener(FocusListener listener)

Adds a focus listener to the list of listeners that should be notified when a focus event occurs.

Parameters:

listener - the focus listener

fireActionEvent

public void fireActionEvent(ActionEvent e)

Fires an action event, notifying any registred listeneres interrested in this type of event.

Parameters:

e - the action event to fire.

fireFocusEvent

public void fireFocusEvent(FocusEvent e)

Fires a focus event, notifying any registred listeners interrested in this typeof event.

Parameters:

e - the focus event to fire.

fireG9ValueChangedEvent

protected void fireG9ValueChangedEvent(int id,
                                       Object oldValue,
                                       Object newValue)

Fires a g9 value changed event.

Parameters:

id - the type of event

oldValue - the old value

newValue - the new value

resetState

public void resetState()

Description copied from interface: G9ValueState

Forces the currently displayed value to be considered the old value.

Specified by:

resetState in interface G9ValueState

isChanged

public boolean isChanged()

Description copied from interface: G9ValueState

Checks if the currently displayed value is the same as the initial value. The initial value is updated when the component is updated programaticly.

Specified by:

isChanged in interface G9ValueState

Returns:

true if the displayed value differs from the initial value.

isClear

public boolean isClear()

Check if the radio group is clear, viz. that no selection is made.

Returns:

true if no selection is made.

updateSelection

public void updateSelection()

Updates initial selected value of this group.

display

public void display(Object o)

Description copied from interface: G9ValueState

Updates the displayed value of the component, without affecting the state of the component.

Specified by:

display in interface G9ValueState

Parameters:

o - the new value to display

getInitialValue

public Object getInitialValue()

Description copied from interface: G9ValueState

Returns the initial displayed value.

Specified by:

getInitialValue in interface G9ValueState

Returns:

the initial displayed value

setInitialValue

public void setInitialValue(Object value)

Description copied from interface: G9ValueState

Sets the initial value to be the specified value.

Specified by:

setInitialValue in interface G9ValueState

Parameters:

value - the (new) initial value.

actionPerformed

public void actionPerformed(ActionEvent e)

Specified by:

actionPerformed in interface ActionListener