Package net.sf.jguiraffe.gui.builder.enablers

A package with classes for enabling or disabling other elements.

See: Description

Interface Summary

Interface	Description
ElementEnabler	Definition of an interface to be implemented by components that can change the enabled state of specific elements.

Class Summary

Class	Description
ActionEnabler	A specialized implementation of the ElementEnabler interface that can change the enabled state of actions.
ActionGroupEnabler	A specialized implementation of the ElementEnabler interface that can change the enabled state of action groups.
ChainElementEnabler	A specialized implementation of the ElementEnabler interface that maintains an arbitrary number of other ElementEnabler objects.
ComponentEnabler	A specialized implementation of the ElementEnabler interface that can change the enabled state of components.
EnablerBuilder	A helper class for the convenient creation of standard ElementEnabler objects.
EnablerConverter	A specialized converter implementation for ElementEnabler objects.
InverseEnabler	A specialized implementation of the ElementEnabler interface that wraps another ElementEnabler and inverses the setEnabledState() implementation of this wrapped enabler.
NullEnabler	A trivial implementation of the ElementEnabler interface that does nothing.

Package net.sf.jguiraffe.gui.builder.enablers Description

A package with classes for enabling or disabling other elements.

In the UI of an application there is often the need to enable or disable certain elements depending on the state the application is in. For instance, some actions may not always be available, but only when the application is in a specific state. Or, when a long-running background process is active, parts of the application must not be changed until the process ends.

With the ElementEnabler interface this package provides a generic mechanism for changing the enabled state of UI elements. The package also contains concrete implementations of the ElementEnabler that deal with specific elements, like GUI components, actions, or windows. Other parts of the framework make use of these classes for implementing automatic enabling or disabling of elements, e.g. during the execution of an action.

With the EnablerBuilder there is also a mechanism for creating ElementEnabler objects based on textual specifications. This is especially useful in builder scripts defining an application's UI as it provides a convenient way of defining ElementEnabler objects.

$Id: package.html 205 2012-01-29 18:29:57Z oheger $