Technique PDF15:Providing submit buttons with the submit-form action in PDF forms

Example 1: Adding a submit button using Adobe Acrobat Pro

This example is shown with Adobe Acrobat Pro. There are other software tools that perform similar functions.

1. Select the Prepare Form tool.
2. Using the Prepare Form toolbar, add a button to the form.
3. Select the button and access the context menu and select the Properties... menu item.
4. In the General tab, provide a Name. This will be used by any JavaScript scripting, so should be a value that can be assigned to a variable.
5. In the General tab, provide a tooltip for the button.
6. In the Options tab, choose an option in the Layout menu for the button label, icon image, or both. Then, type text in the Label box to identify the button as a submit button and/or click Choose Icon and locate the image file you want to use.
7. In the Actions tab:
   • For Select Trigger, choose Mouse Up. (The Mouse Up event is keyboard accessible and, in addition, ensures that the button will not change context unexpectedly, as it might with with a Mouse Enter event.)
   • For Select Action, choose Submit A Form.
   • Click Add.
8. In the Add dialog, enter a URL to collect data on a server or collect form data as e-mail attachments.

Example 2: Adding a script action to a submit button in a PDF document using JavaScript

The following JavaScript code illustrates the use of a script to specify the submit-form action. To add this script to the form field:

1. Open the Button Properties dialog, as shown in Example 1, and select the Actions tab
2. Select Run a JavaScript from the drop-down list, and select the Add button
3. Enter JavaScript code in the JavaScript Editor dialog.

This example is shown in operation in the working example of adding a script action to a submit button.