Package net.sf.jguiraffe.gui.builder.event

The main package for events and event listeners definitions.

See: Description

Interface Summary

Interface	Description
FormActionListener	Definition of an interface for action listeners.
FormChangeListener	Definition of an interface for change listeners.
FormEventListener	Base interface for listeners for form events.
FormFocusListener	Definition of an interface for focus listeners.
FormMouseListener	Definition of interface for mouse listeners.
PlatformEventManager	Definition of an interface for dealing with platform (i.e. a specific GUI library) specific events.

Class Summary

Class	Description
BuilderEvent	The base class of events used in the form and form builder framework.
FormActionEvent	A specific event class for dealing with action events.
FormChangeEvent	A specific event class for change events.
FormEvent	An event class used in the form and form builder framework to deliver event information related to form elements (controls or input components).
FormEventManager	The main class for event handling in the form framework.
FormFocusEvent	A specific event class dealing with focus events.
FormMouseEvent	A specialized event class for reporting events related to mouse actions.

Enum Summary

Enum	Description
FormFocusEvent.Type	An enumeration class defining the different types of focus events.
FormListenerType	An enumeration class describing the supported event listener types.
FormMouseEvent.Type	An enumeration class defining constants for the possible mouse actions that can trigger a FormMouseEvent.
Keys	An enumeration class defining constants for special keys on a standard keyboard.
Modifiers	An enumeration class representing special modifier keys.

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

The main package for events and event listeners definitions.

The JGUIraffe library provides generic event types independent of specific GUI toolkits. The following generic event types (and corresponding listeners) are supported:

• Action events: Events of this type are triggered, e.g. by command buttons or menu items. They indicate that the user has issued a command.
• Focus events are triggered when a control gains or loses the keyboard focus.
• Change events are a generic mechanism for indicating that a control was somehow changed. This could mean, for instance, that a selection in a list or a tree control was changed or that the user has entered text into a text field.
• Window events: They are related to windows, e.g. opening a window, closing a window, or activating it.

For each event type a corresponding listener interface exists. The methods provided by these interfaces are similar to those supported by typical GUI toolkits.

In addition to the event classes and event listener interfaces this package contains the FormEventManager class, which is the central component for registering event listeners at GUI components. It provides methods for adding listeners of all types either globally or at specific controls. Alternatively special tags in builder scripts can be used for registering event listeners.

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