Form

Description

Forms act as containers for controls. To go to a new form, use the ChangeForm() function.

To add a Form to your app, choose Add Form from the Project menu at the top of the screen. Forms can be deleted in the Project Explorer.

The information on a form can be submitted to a URL by calling the form.submit() function. The values for all controls on the form which have their Name property defined will be appended to the URL as an HTML query string.

Properties

Standard properties are supported, plus:

height	The height of the form. Default is 460 pixels.
left	The left position of the form. Use this for forms that are not full screen.
fullscreen	The form will automatically be the same size as the device screen. The Design Screen will still use height and width.
method	Get or Post. The method that the http form is sent by.
openMode	Should the form be open at startup? Use this for forms which are to remain open. There is no need to set this for the first form of the project: that is set in Project Properties.
style	The CSS style for the form. Will override the background. background: -webkit-gradient(linear, left top, left bottom, from(#55aaee), to(#003366)); This will not take effect until the form is redrawn. Form1.height = SysInfo(3) will do this.
Url	The URL to be called when the form is submitted using the submit() function.
width	The width of the form. Default is 320 pixels.
reset()	Clear all fields on the form. Runtime only.
submit()	Submit the data on the form to the specified URL. Runtime only. See Location as well.

Events

Standard events are supported, plus:

onhide()	Called when form hidden as a result of ChangeForm()
onkeypress(event)	Called when a key is tapped on a form.
onshow()	Called by firstform and when form is shown as a result of ChangeForm()
onsubmit()	Called when a form is submitted.

Example (Basic)

Function btnSendData_onclick()
  Form1.submit()
End Function

To prevent a form from being submitted when the return key is entered in a field:

Function Form1_onsubmit()
  window.event.cancelBubble=True
  window.event.returnValue=False
End Function

Example (JavaScript)

btnSendData.onclick = function() {
  Form1.submit();
}

To prevent a form from being submitted when the return key is entered in a field:

Form1.onsubmit = function() {
  window.event.cancelBubble=true;
  window.event.returnValue=false;
}

Output

(Url is called with values in the query string)

Related Items

ChangeForm, GetUrlParameter, Properties