Class wtForm

Object
   |
   +--wtObject
         |
         +--wtForm

class wtForm

extends wtObject

A container of form input widgets, whose values can be submitted to server via wtRemoteProcedureCall. Submitting a wtForm is analogous to submitting a wtRemoteProcedureCall, except that the RPC value object is subtituted by a dictionary of <form input name>: <form input value> pairs.

Available signals:

• SubmitSuccess
• SubmitFailure
• Submit
• Reset
• AfterSubmit
• ValueChanged

- wtRemoteProcedureCall

Constructor Detail

wtForm

wtForm(<String> cgi, <String> procName)

Constructs a container of form input widgets, whose values can be submitted to server via wtRemoteProcedureCall.

Parameters:
cgi - The CGI script URL for receiving the form input values
procName - The RPC call name

See:
- wtRemoteProcedureCall

abort

void abort()

Aborts form submission.

addWidget

void addWidget(widget)

Adds a form input widget to the form.

Parameters:
Form - input widget

endProxy

void endProxy()

Disconnects the weak reference and removes the memory expensive object from the weak reference table.

isEnabled

Boolean isEnabled()

Tells whether the form is enabled or not.

Returns:
Whether the form is enabled or not.

reset

void reset()

Resets the form.

TODO: I think it does not currently work!

setEnabled

void setEnabled(<Boolean> yes)

Sets the form to be enabled or disabled. A disabled form has all its input elements grayed out and is unable to receive user input.

Parameters:
yes - Whether the form should be enabled or not.

setFailureHandler

void setFailureHandler(<Function> handler)

Sets the form submission failure handler.

Parameters:
handler - Failure event handler. Input arguments of the handler follow the universal event handler format in WT Toolkit.

See:
- wtObject.connect()

setSuccessHandler

void setSuccessHandler(<Function> handler)

Sets the form submission success handler.

Parameters:
handler - Success event handler. Input arguments of the handler follow the universal event handler format in WT Toolkit.

See:
- wtObject.connect()

submit

void submit()

Submits the form.