sk.uniba.euromath.gene
Interface IConfigurator

public interface IConfigurator

Configures an instance of coordinator. Usage story is as follows:

• createVisuals() is called and the composite is displayed.
• setAcceptListener() is called to set up an listener listening to changes on the 'visuals' composite.
• configurator calls listener's acceptanceChanged() method telling the GENE framework whether it accepts values selected on the 'visuals' composite or not.
• finish() may be called anytime to finish the configuration process. After call to finish() method, no methods are called on this configurator instance.

Author:

Martin Vysny

Method Summary

void	createVisuals(Composite parent) Creates a visual representation of a configurator that is able to configure the coordinator.
void	finish(boolean cancel) Cleans the configuration utility and may retrieve data from the 'visuals' composite.
void	setAcceptListener(IAcceptListener listener) Registers a listener that listens to changes on the components created by the createVisuals().

Method Detail

createVisuals

void createVisuals(Composite parent)

Creates a visual representation of a configurator that is able to configure the coordinator. Children of parent are disposed automatically. The method may be called multiple times (for example when user rewinds the wizard to the beginning). Each call invalidates previously created visuals; these visuals are disposed automatically.

parent may have any layout manager selected, you cannot rely on some particular layout manager. Parent must not be modified - you must not change its layout manager. It is best to create your own composite and place all controls there.

Parameters:

parent - create visuals as children of this parent.

setAcceptListener

void setAcceptListener(IAcceptListener listener)

Registers a listener that listens to changes on the components created by the createVisuals(). Replaces previous listener. You may assume that createVisuals() has already been called. If not null, new listener's acceptanceChanged() method must be called immediately, to reflect current state of configurator visuals.

Parameters:

listener - listener to register, if null then unregister previous listener.

finish

void finish(boolean cancel)

Cleans the configuration utility and may retrieve data from the 'visuals' composite. The composite should not be disposed here - it is disposed automatically later.

Parameters:

cancel - if true then the export process is cancelled.