de.tif.jacob.screen.event
Class IMutableComboBoxEventHandler

java.lang.Object
  EventHandler
      de.tif.jacob.screen.event.GuiEventHandler
          de.tif.jacob.screen.event.IGroupMemberEventHandler
              de.tif.jacob.screen.event.IComboBoxEventHandler
                  de.tif.jacob.screen.event.IMutableComboBoxEventHandler

public abstract class IMutableComboBoxEventHandler
extends IComboBoxEventHandler

Abstract event handler class for mutable list boxes. Derived implementations of this event handler class have to be used to "hook" application-specific business logic to mutable list boxes.

Field Summary

static java.lang.String	RCS_ID The internal revision control system id.
static java.lang.String	RCS_REV The internal revision control system id in short form.

Constructor Summary

IMutableComboBoxEventHandler()

Method Summary

void	onGroupStatusChanged(IClientContext context, IGuiElement.GroupState state, IGuiElement combobox) This event method will be called, if the status of the corresponding group has been changed.
abstract void	onGroupStatusChanged(IClientContext context, IGuiElement.GroupState state, IMutableComboBox comboBox) This event method will be called, if the status of the corresponding group has been changed.
void	onSelect(IClientContext context, IComboBox comboBox) This hook method will be called, if the user selects a new item in the combo box.
abstract void	onSelect(IClientContext context, IMutableComboBox comboBox) This hook method will be called, if the user selects a new item in the mutable list box.

Methods inherited from class de.tif.jacob.screen.event.IGroupMemberEventHandler

onHide, onShow

Methods inherited from class de.tif.jacob.screen.event.GuiEventHandler

alert, alert, alert

Methods inherited from class java.lang.Object

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

Field Detail

RCS_ID

public static final transient java.lang.String RCS_ID

The internal revision control system id.

See Also:

Constant Field Values

RCS_REV

public static final transient java.lang.String RCS_REV

The internal revision control system id in short form.

See Also:

Constant Field Values

Constructor Detail

IMutableComboBoxEventHandler

public IMutableComboBoxEventHandler()

Method Detail

onGroupStatusChanged

public final void onGroupStatusChanged(IClientContext context,
                                       IGuiElement.GroupState state,
                                       IGuiElement combobox)
                                throws java.lang.Exception

Description copied from class: IGroupMemberEventHandler

This event method will be called, if the status of the corresponding group has been changed. Derived event handlers could overwrite this method, e.g. to enable/disable GUI elements in relation to the group state.
Possible group state values are defined in IGuiElement:

• IGuiElement.UPDATE
• IGuiElement.NEW
• IGuiElement.SEARCH
• IGuiElement.SELECTED

Overrides:

onGroupStatusChanged in class IGroupMemberEventHandler

Parameters:

context - The current client context

state - The new group state

combobox - The corresponding GUI element to this event handler

Throws:

java.lang.Exception

onGroupStatusChanged

public abstract void onGroupStatusChanged(IClientContext context,
                                          IGuiElement.GroupState state,
                                          IMutableComboBox comboBox)
                                   throws java.lang.Exception

This event method will be called, if the status of the corresponding group has been changed. Derived event handlers could overwrite this method, e.g. to enable/disable GUI elements in relation to the group state.
Possible group state values are defined in IGuiElement:

• IGuiElement.UPDATE
• IGuiElement.NEW
• IGuiElement.SEARCH
• IGuiElement.SELECTED

Parameters:

context - The current client context

state - The new group state

listBox - The corresponding GUI element to this event handler

Throws:

java.lang.Exception

onSelect

public final void onSelect(IClientContext context,
                           IComboBox comboBox)
                    throws java.lang.Exception

Description copied from class: IComboBoxEventHandler

This hook method will be called, if the user selects a new item in the combo box.

Then overwriting this method, this is a good place for enable/disable other GUI elements.

Note: This method will only be invoked, if the corresponding group state is either IGuiElement.NEW or IGuiElement.UPDATE.

Specified by:

onSelect in class IComboBoxEventHandler

Parameters:

context - the current client context

comboBox - the combo box itself

Throws:

java.lang.Exception

onSelect

public abstract void onSelect(IClientContext context,
                              IMutableComboBox comboBox)
                       throws java.lang.Exception

This hook method will be called, if the user selects a new item in the mutable list box.

Then overwriting this method, this is a good place for enable/disable other GUI elements.

Note: This method will only be invoked, if the corresponding group state is either IGuiElement.NEW or IGuiElement.UPDATE.

Parameters:

context - the current client context

listBox - the mutable listbox itself

Throws:

java.lang.Exception