In Designer, you
can script against certain JavaScript objects in Acrobat by using the
Acrobat scripting syntax. As a result, you can use the properties
and methods of those objects on your form. For example, to display
a message in the JavaScript Console from Acrobat, you can add the
following script to the event of a form design object in Designer:
console.println("This message appears in the JavaScript Console.");
You can also have the form send itself by email by adding the
following script to the
click
event of a button:
var myDoc = event.target;
myDoc.mailDoc(true);
Note:
In Designer, you must ensure that the scripting
language for the event is set to JavaScript so that the script will
execute correctly at run time.
You can also use references to the JavaScript objects in Acrobat
in your reference syntax. For example, the following script gets
the signed state of a signature field and takes an action based
on the state:
// Proceed if the current field is not signed.
var oState =
event.target.getField("form1[0].#subform[0].SignatureField1[0]")
.signatureValidate(); //Get the field's signed state.
if (oState == 0) {
...
}
When working with JavaScript from Acrobat in Designer, remember
these points:
-
In Designer, use
event.target
to access
the
Doc
JavaScript object from Acrobat. In Acrobat,
the
this
object is used to reference the
Doc
object; however,
in Designer, the
this
object refers to the form
design object to which the script is attached.
-
The Script Editor has no statement completion for JavaScript
objects from Acrobat. See the
JavaScript for Acrobat API Reference
.
-
The Doc method
event.target.importTextData("file.txt")
is not
supported for dynamic XFA forms that have been certified.
For
more information about converting Acrobat scripting to Designer,
see the article
Converting Acrobat JavaScript for Use in
Designer Forms
in the Developer Center.