A panel that wraps its contents in an HTML <FORM> element.
This panel can be used to achieve interoperability with servers that accept
traditional HTML form encoding. The following widgets (those that implement
com.google.gwt.user.client.ui.HasName ) will be submitted to the
server if they are contained within this panel:
In particular,
com.google.gwt.user.client.ui.FileUpload is only
useful when used within a FormPanel, because the browser will only upload
files using form submission.
Used with
FormPanel.setMethod(String) to specify that the form will be
submitted using an HTTP POST request (necessary for
FileUpload to
work properly).
Creates a new FormPanel. When created using this constructor, it will be
submitted to a hidden <iframe> element, and the results of the
submission made available via
FormHandler .
The back-end server is expected to respond with a content-type of
'text/html', meaning that the text returned will be treated as HTML. If any
other content-type is specified by the server, then the result html sent in
the onFormSubmit event will be unpredictable across browsers, and the
FormHandler.onSubmitComplete(FormSubmitCompleteEvent) event may not
fire at all.
Creates a FormPanel that targets a
NamedFrame . The target frame is
not physically attached to the form, and must therefore still be added to a
panel elsewhere.
When the FormPanel targets an external frame in this way, it will not fire
the onFormSubmit event.
Parameters: frameTarget - the NamedFrame to be targetted
Gets the form's 'target'. This is the name of the
NamedFrame that
will receive the results of submission, or null if none has
been specified.
the form's target.
The FormPanel must not be detached (i.e. removed from its parent
or otherwise disconnected from a
RootPanel ) until the submission
is complete. Otherwise, notification of submission will fail.
Methods inherited from com.google.gwt.user.client.ui.SimplePanel
