FormPanel uses a
com.gwtext.client.widgets.layout.FormLayout internally, and that is required for fields and labels
to work correctly within the FormPanel's layout. To nest additional layout styles within a FormPanel, you should nest
additional Panels or other containers that can provide additional layout functionality. You should not override FormPanel's layout.
setTimeout(int timeout) Timeout for form actions in seconds (default is 30 seconds).
public void
setTrackResetOnLoad(boolean trackResetOnLoad) If set to true, form.reset() resets to the last loaded or setValues() data instead of when the form was first created.
public void
setUrl(String url) The URL to use for form actions if one isn't supplied in the action options.
Add a Form listener. Although you can add this listener on the
com.gwtext.client.widgets.form.Form directly, this method is useful to call when you would like to add a FormListener prior to the FormPaanel being rendered.
Parameters: listener - the form listener
Provides access to the Form which this Panel contains. Note that this method must be called only after the FormPanel has been
rendered. Returns null if called before the FormPanel has been rendered.. If you need to add a listener to he form prior to
the FormPanel being rendered, call
FormPanel.addFormListener(com.gwtext.client.widgets.form.event.FormListener) instead.
the underlying Form, or null if FormPanel not rendered
Parameters to pass with all requests. This effectively acts like Form hidden fields.
Parameters: params - the base params throws: IllegalStateException - this property cannot be changed after the Component has been rendered
Valid values are "left," "center" and "right" (defaults to "center").
Parameters: buttonAlign - form button position throws: IllegalStateException - this property cannot be changed after the Component has been rendered
A
com.gwtext.client.data.Reader (e.g.
com.gwtext.client.data.XmlReader ) to be used to read data when reading validation errors on "submit" actions.
This is completely optional as there is built-in support for processing JSON.
Parameters: errorReader - the error reader throws: IllegalStateException - this property cannot be changed after the Component has been rendered
Set true if this form is a file upload.
Parameters: fileUpload - true if file upload throws: IllegalStateException - this property cannot be changed after the Component has been rendered
Set to true to hide all field labels.
Parameters: hideLabels - true to hide field labels throws: IllegalStateException - this property cannot be changed after the Component has been rendered
A CSS class to apply to the x-form-item of fields. This property cascades to child containers.
Parameters: itemCls - CSS class throws: IllegalStateException - this property cannot be changed after the Component has been rendered
Valid values are "left," "top" and "right" (defaults to "left"). This property cascades to child containers if not set.
Parameters: labelAlign - label alignment throws: IllegalStateException - this property cannot be changed after the Component has been rendered
The width of labels. This property cascades to child containers.
Parameters: labelWidth - the label width throws: IllegalStateException - this property cannot be changed after the Component has been rendered
The request method to use (GET or POST) for form actions if one isn't supplied in the action options.
Parameters: method - the request method throws: IllegalStateException - this property cannot be changed after the Component has been rendered
Minimum width of all buttons in pixels (defaults to 75).
Parameters: minButtonWidth - min button width throws: IllegalStateException - this property cannot be changed after the Component has been rendered
The milliseconds to poll valid state, ignored if monitorValid is not true (defaults to 200).
Parameters: monitorPoll - the monitor poll in milliseconds throws: IllegalStateException - this property cannot be changed after the Component has been rendered
If true the form monitors its valid state client-side and fires a looping event with that state. This is required
to bind buttons to the valid state using the config value formBind:true on the button.
Parameters: monitorValid - true to enable monitoring throws: IllegalStateException - this property cannot be changed after the Component has been rendered
A
Reader (e.g.
com.gwtext.client.data.XmlReader ) to be used to read data when executing "load" actions.
This is optional as there is built-in support for processing JSON.
Parameters: reader - the load Reader throws: IllegalStateException - this property cannot be changed after the Component has been rendered
Timeout for form actions in seconds (default is 30 seconds).
Parameters: timeout - timeout in seconds throws: IllegalStateException - this property cannot be changed after the Component has been rendered
If set to true, form.reset() resets to the last loaded or setValues() data instead of when the form was first created.
Parameters: trackResetOnLoad - true to track reset on load throws: IllegalStateException - this property cannot be changed after the Component has been rendered
The URL to use for form actions if one isn't supplied in the action options.
Parameters: url - the url throws: IllegalStateException - this property cannot be changed after the Component has been rendered
By default wait messages are displayed with
com.gwtext.client.widgets.MessageBox.wait(long) .
You can target a specific element by passing its id.
Parameters: waitMsgTarget - ID of the Element to mask throws: IllegalStateException - this property cannot be changed after the Component has been rendered
By default wait messages are displayed with
com.gwtext.client.widgets.MessageBox.wait(long) .
You can mask the form itself by passing in true.
Parameters: waitMsgTarget - true to mask the form throws: IllegalStateException - this property cannot be changed after the Component has been rendered