com.sdm.quasar.client.swing.commands.adapters
Class JComboBoxCommandAdapter

java.lang.Object
  com.sdm.quasar.client.core.commands.AbstractCommandAdapter
      com.sdm.quasar.client.swing.commands.adapters.JComboBoxCommandAdapter

All Implemented Interfaces:

CommandAdapter, Disposable

public class JComboBoxCommandAdapter

extends AbstractCommandAdapter

The JComboBoxCommandAdapter is an bidirectional adapter between an JComboBox and a Command:

It trigges the Command, when the ActionEvent is fired and it sets the state of the JComboBox due to the executable BooleanState of the Command.

Caution: Be careful using this adapter for two reasons:

• The command is triggered when ever the selection is changed, e.g. by the user as well as from your program code
• In conjunction with data binding you can't be sure, that your bound object has been updated before the command is triggered.

Author:

Thomas Wolf, Martin Haft

Constructor Summary

JComboBoxCommandAdapter(javax.swing.JComboBox jcombobox, Command command)
Creates a new JComboBoxCommandAdapter.

JComboBoxCommandAdapter(java.lang.String name, javax.swing.JComboBox jcombobox, Command command)
Creates a new JComboBoxCommandAdapter.

Method Summary

void	dispose() Disposes the component.
BooleanState	getEnabledBooleanState()
javax.swing.JComboBox	getJComboBox() Returns the JComboBox adapted to the command.
void	setCommand(Command command) Sets (or resets if command==null) the Command this adapter adapts.
void	setEnabledBooleanState(BooleanState enabledState) Sets the BooleanState that controls the enabled state of the adapted JComponent.
void	setJComboBox(javax.swing.JComboBox jcombobox) Sets the JComboBox to adapt to the command.

Methods inherited from class com.sdm.quasar.client.core.commands.AbstractCommandAdapter

executeCommand, getCommand, getName, setName

Methods inherited from class java.lang.Object

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

Constructor Detail

JComboBoxCommandAdapter

public JComboBoxCommandAdapter(javax.swing.JComboBox jcombobox,
                               Command command)

Creates a new JComboBoxCommandAdapter.

JComboBoxCommandAdapter

public JComboBoxCommandAdapter(java.lang.String name,
                               javax.swing.JComboBox jcombobox,
                               Command command)

Creates a new JComboBoxCommandAdapter.

Parameters:

name -

Method Detail

setCommand

public void setCommand(Command command)

Description copied from interface: CommandAdapter

Sets (or resets if command==null) the Command this adapter adapts.

Specified by:

setCommand in interface CommandAdapter

Overrides:

setCommand in class AbstractCommandAdapter

See Also:

AbstractCommandAdapter.setCommand(com.sdm.quasar.client.core.commands.Command)

getJComboBox

public javax.swing.JComboBox getJComboBox()

Returns the JComboBox adapted to the command.

setJComboBox

public void setJComboBox(javax.swing.JComboBox jcombobox)

Sets the JComboBox to adapt to the command.

Parameters:

jcombobox - the JComboBox to adapt

getEnabledBooleanState

public BooleanState getEnabledBooleanState()

Returns:

a BooleanState that controls the enabled state of the adapted JComponent.

setEnabledBooleanState

public void setEnabledBooleanState(BooleanState enabledState)

Sets the BooleanState that controls the enabled state of the adapted JComponent.

Parameters:

enabledState - the BooleanState to use

dispose

public void dispose()
             throws DisposeException

Description copied from interface: Disposable

Disposes the component.

Important:
This method is called by an administrating component and must never be called directly.

The implementation should release any resources or objects allocated and any services registered. Furthermore, this method should be developed carefully to free a maximum of resources even when the system may have become unstable. In case of one or multiple errors, you should collect them in a DisposeException, continue with the execution, and throw it at the end of the method.

Note: The implementation must not return before the component is disposed. Any threads or asynchronous calls started must be completed before this method returns.

Throws:

DisposeException - if there was one or more errors while disposing the component.

See Also:

Disposable.dispose()