submitForm( )

Description

Submits a form.

Property of

Form object

JavaScript synopsis
submitForm(
  confirmMessage,
  followOffsiteLinks, 
  includeImages,
  linkDepth, 
  maxSize, 
  trashResponse, 
  isMulti, 
  isHidden, 
  displayDefaultMsg)
JavaScript Parameters
  • confirmMessage   Displays a message to the user in a confirmation dialog. This argument can be NULL, which suppresses the display of the dialog to the user.

    Note: The user cannot cancel, only confirm.

  • followOffsiteLinks   If true, the response page can be outside the Web site's domain. If false, offsite links are disallowed. The default is false.

  • includeImages   If true, the response can contain images. Otherwise false. The default is true.

  • linkDepth   An integer specifying the number of levels of links to follow when downloading the page. Typically, this is 0, which just downloads the main response page. A value of 1 indicates that M-Business Client should traverse all of the links on the response page and download those pages as well. The default is 0.

  • maxSize   Specifies maximum size in kilobytes of the response.

  • trashResponse   If true, do not display the response page. As soon as the user successfully submits the form, delete the form submission from the user's device.

  • isMulti   If true, the user can submit the same form many times. If false, the user can submit only one form request at a time against a particular Web page.

  • isHidden   If true, the form should not be listed in the Forms Manager page. Setting this argument to true and trashResponse to true allows you to handle form requests silently, without the user having to know that an HTML form was used.

  • displayDefaultMsg   If true, a default message appears. If false, the message does not appear.