User manual ADOBE ACROBAT FORMS JAVASCRIPT OBJECT SPECIFICATION

[. . . ] bc Adobe® Acrobat® Technical Note # 5186 Acrobat Forms JavaScript Object Specification Version 4. 0 Revised: January 27, 1999 © 1999 Adobe Systems Incorporated. The information in this document is furnished for informational use only, is subject t change without notice, and should not be construed as a commitment by Adobe Systems Incorporated. Adobe Systems Incorporated assumes no responsibility or liability for any errors or inaccuracies that may appear in this document. The software described in this document is furnished under license and may only be used or copied in accordance with the terms of such license. [. . . ] When a full calculation is needed, each of the fields in the array is calculated in turn starting with the zeroth index of the array and continuing in sequence to the end of the array. To change the calculation order of fields, use the Tools->Forms->JavaScript->Set Calculation Order. . . menu item in Adobe Acrobat. Format Once all dependent calculations have been performed the format event is triggered. This event allows the attached JavaScript to change the way that the data value appears to a user (also known as its presentation or appearance). For example, if a data value is a number and the context in which it should be displayed is currency, the formatting script can add a dollar sign ($) to the front of the value and limit it to two decimal places past the decimal point. Acrobat Forms - JavaScript Object Specification 32 Event Object Properties change Type: String Event: Keystroke, Selection ChangeAccess: R/W This property specifies the change in value that the user has just typed. The change is replaceable such that if the JavaScript wishes to substitute certain characters, it may. commitKey Type: Number Event: Keystroke, Format Access: R 4. 0 Use this property to determine how a form field lost focus. 1 - value was committed because of a click outside the field using the mouse. For example, to automatically display an alert dialog after a field has been committed add the following to the field's format script: if (event. commitKey != 0) app. alert("Thank you for your new field value. "); modifier Type: Boolean Event: Keystroke, Mouse events Access: R This property is a boolean that specifies whether the modifier key is down during a particular event. The modifier key on the Microsoft Windows platform is Control and on the Macintosh platform is Option or Command. The modifier property is not supported on UNIX. rc Type: Boolean Event: Keystroke, Validate Access: R/W This property is used for validation. It indicates whether a particular event in the event chain should succeed. Set rc to false to prevent a change from occurring or a value from committing. By default rc is true. Acrobat Forms - JavaScript Object Specification 33 For each event, except the mouse related events, the static event object is populated with the following data. In most events, it is important for JavaScript to set the rc (return code) property to indicate that the event can proceed. selEnd Type: Integer Event: Keystroke Access: R/W This property specifies the ending position of the current text selection during a keystroke event. selStart Type: Integer Event: Keystroke Access: R/W This property specifies the starting position of the current text selection during a keystroke event. shift Type: Boolean Event: Keystroke, Mouse events Access: R This property is a boolean that specifies whether the shift key is down during a particular event. target Type: Object Event: All events Access: R This property contains the target object that triggered the event. In other events like page open and close it is the document or this Object. value Type: Various Event: Validate, Calculate, Format, SelChange Access: R/W For the validate event, value is the value that the field contains when it is committed. For example, the following JavaScript verifies that the field value is between zero and 100. Example: if (event. value < 0 || event. value > 100) { app. beep(0); Acrobat Forms - JavaScript Object Specification 34 app. alert("Invalid value for field " + event. target. name); event. rc = false; } For a calculate event, JavaScript should set this property. This is the value that the field should take upon completion of the event. For example, the following JavaScript sets the calculated value of the field to the value of the SubTotal field plus tax. var f = this. getField("SubTotal"); event. value = f. value * 1. 0725; For a format event, JavaScript should set this property. For example, the following JavaScript formats the field as a currency type of field. event. value = util. printf("$%. 2f", event. value); willCommit Type: Boolean Event: Keystroke Access: R Use this property to verify the current keystroke event before the data is committed. This is useful to check the target form field values and for example verify if character data instead of numeric data was entered. JavaScript sets this property to true after the last keystroke event and before the field is validated. [. . . ] */ var d2 = new Date(num); /* Print out the current date and our new date using util. printd */ console. println("It is currently: " + util. printd("mm/dd/yyyy", d1)); console. println("In 13 days, it will be: " + util. printd("mm/dd/yyyy", d2)); The output of this script would look something like: It is currently: 01/15/1999 In 13 days, it will be: 01/28/1999 Acrobat Forms and Security Security in Acrobat takes on the form of restricting access to a document, restricting permissions for a form once it has been opened, and digital signatures. Restricting Access If the author desires to restrict access to the form in its entirety then the standard security model in Acrobat can be selected and an open password defined that requires a user to type in a password before opening the form. Other security handlers exist and are provided by third party developers as plug-ins and may also be useful. using a public/private key Acrobat Forms - JavaScript Object Specification 61 infrastructure to lock a form for a particular set of people or allowing a form to expire after a certain time period. The ability to set a user password is accessed using the Save As function by choosing the appropriate security handler and configuring its settings. Restricting Permissions The standard security model in Acrobat is accessible at document save time and allows you to set the following restrictions on the document: printing, changing the document, selecting text and graphics, and adding and changing annotations and form fields. [. . . ]