Nitro PDF Professional User Guide

82
Nitro PDF Professional User Guide
know where to look for JavaScripts. In Nitro PDF Professional you can find JavaScripts in the following
locations:
· Field scripts. JavaScripts can be used with all field types. In all fields you can add scripts in the Set
Actions properties. In signature fields you can add JavaScripts in both the Set Action properties and in
the Signed properties. By far the most opportunity you have for adding scripts in field properties is
with text fields. In text fields you can add scripts to:
o Format properties. Open the Format properties and select Custom from the Select format
category drop down menu. JavaScripts are added to create a Custom Format Script and
Custom Keystroke Script.
o Validate. Open the Validate properties and select Run custom validation script to add a
JavaScript to validate field data.
o Calculate. The Calculate properties are likely to be the most frequent area where JavaScripts
are created. You can write scripts in two areas. Click the Simplified field notation button and
you can write scripts using syntax similar to spreadsheet formulas. Click the Custom calculation
script and you can write JavaScripts to calculate field data.
o Set Action. Like the other fields, text fields support the Run JavaScript action type.
· JavaScript console. You can open the JavaScript Console and write a script that doesn’t belong to
any field or element. Scripts written in the JavaScript Console can be used to test routines and debug
code.
· Document Actions. Opening, saving and printing PDFs are all document actions. JavaScripts can be
written when these actions occur. To add a Document Action, go to the Forms ribbon tab, in the
JavaScript group, click Document Actions.
· Document level JavaScripts. A document level JavaScript can be a function that other scripts call in
subroutines. These scripts are contained at the document level and can be executed by another script
or when opening a file.
· Folder level JavaScripts. A folder level JavaScript is located outside of the PDF file and can be used
by more than one PDF. When Nitro PDF Professional is opened the scripts are run.
12.12.2 Copying and pasting JavaScripts
JavaScripts can be copied and pasted from one field or other location in a PDF document or between two
documents. If you examine PDF files for learning JavaScript programming, you can browse PDF files
containing scripts, copy a script from a document you download from the Internet, and paste the code into
the JavaScript Editor in your document. With a little code modification, you can quickly add scripts to your
own files.
To copy code between PDF files just open them both in Nitro PDF Professional.
12.12.3 Using folder level JavaScript
Folder level JavaScripts are JavaScript files (.JS) that are run during application startup. These can be useful
for loading reusable JavaScript functions into the application, or accessing methods/properties whose
security restrictions only allow them to be run in the app/init event.
Simple examples include loading the user's Windows login into a global JavaScript variable at startup, or
loading a list of employee names from your company into a JS array at startup which can be used by the
forms that are opened in Nitro PDF Professional.
To add or edit a folder level JavaScript:
1. Open Nitro PDF Professional.
2. On the Form ribbon tab, in the JavaScript group, click Folder Level .
© 2008 Nitro PDF Software