A widget that serves as a container for other widgets, the top-level widget in
a form description file.
author: Bruno Dumon author: Sylvain Wallez version: CVS $Id: Form.java 433543 2006-08-22 06:22:54Z crossley $
addWidgetEvent(WidgetEvent event) Events produced by child widgets should not be fired immediately, but queued in order to ensure
an overall consistency of the widget tree before being handled.
Events produced by child widgets should not be fired immediately, but queued in order to ensure
an overall consistency of the widget tree before being handled.
Parameters: event - the event to queue
Get the widget that triggered the current processing. Note that it can be any widget, and
not necessarily an action or a submit.
the widget that submitted this form.
Processes a form submit. If the form is finished, i.e. the form should not be redisplayed to the user,
then this method returns true, otherwise it returns false. To know if the form was sucessfully
validated, use the
Form.isValid() method.
Form processing consists in multiple steps:
all widgets read their value from the request (i.e.
Form.readFromRequest(FormContext) is called recursively on
the whole widget tree)
if there is an action event, call the FormHandler
perform validation.
This processing can be interrupted by the widgets (or their event listeners) by calling
Form.endProcessing(boolean) .