Home » Adobe Manuals » Computer Software » Adobe 12001196 » Manual Viewer

Adobe 12001196 Scripting Guide - Page 40

Debugger Scripts Window, Accessing Scripts in the Scripts Window, Scripts Inside PDF Files

UPC - 718659085742

View all Adobe 12001196 manuals

Add to My Manuals
Save this manual to your list of manuals

Page 40 highlights

3 Acrobat JavaScript Debugger Debugger Scripts Window Debugger Scripts Window Scripts are automatically collected from a PDF file open in Acrobat when you open the debugger dialog. The debugger displays these in the Scripts window. Figure 3.5 shows an example. FIGURE 3.5 Scripts window Accessing Scripts in the Scripts Window To access scripts you want to display, you click the triangle next to an entry in the Scripts window to open the next level down. Continue to click triangles to open the next lower level. Use the scroll bar, if necessary, to view the contents in the window as you open lower levels. A script icon indicates that a script is defined for an action or function. In Figure 3.5, a function is defined for a mouse-up action on a button-type form named Button1. Clicking on the script icon opens the debugger at the location of the first script statement. Acrobat JavaScripts can be stored in several places, either inside or outside PDF files. Scripts that live inside a PDF file are associated with an action of type JavaScript. The following sections contain lists of possible locations for scripts, inside or outside a PDF file. These scripts are immediately available for viewing and debugging in with the Acrobat JavaScript Debugger Scripts Inside PDF Files Table 3.3 lists the PDF-file script types that can be displayed in the Scripts window. You can view and debug these scripts anytime that you open the debugger dialog. You can edit these scripts from inside the debugger and you can set breakpoints as described in Breakpoints on page 44. Changes to scripts do not take effect until the scripts are re-run; you cannot make changes to a running script. TABLE 3.3 Scripts inside PDF files Location Document level Access Advanced > JavaScript > Document JavaScripts 40 Acrobat JavaScript Scripting Guide

Section	Page
Acrobat JavaScript Scripting Guide	1
Contents	3
Preface	7
Introduction	7
Audience	7
Purpose and Scope	7
Assumptions	8
Organization	8
How To Use This Guide	8
Font Conventions Used in This Book	9
For More Information	10
Introduction to Acrobat JavaScript	11
Introduction	11
Chapter Goals	11
Contents	11
Overview	11
What Is Acrobat JavaScript?	12
What Can You Do with Acrobat JavaScript?	13
Acrobat JavaScript Object Overview	15
The App object	15
The Doc Object	15
Other Common Acrobat JavaScript Objects	16
Database Objects	17
JavaScript Language Caveats	17
Acrobat JavaScript Editor and Debugger Console	19
Introduction to the JavaScript Editor and Debugger Console	19
Chapter Goals	19
Contents	19
JavaScript Console	20
Opening the JavaScript Console	20
Executing JavaScript	20
Formatting Code	20
Using a JavaScript Editor	21
Specifying the Default JavaScript Editor	23
Using the Built-in Acrobat JavaScript Editor	24
Using an External Editor	24
Additional Editor Capabilities	24
Specifying Additional Capabilities to Your Editor	25
Testing Whether Your Editor Supports Opening at Syntax Error Locations	26
Exercise: Working with the JavaScript Console	27
Enabling JavaScript	27
Enabling the Interactive JavaScript Console	28
Trying out the JavaScript Console	28
Acrobat JavaScript Debugger	33
Introduction to the Acrobat JavaScript Debugger	33
Chapter Goals	33
Contents	33
Enabling the Acrobat JavaScript Debugger	34
Debugger Dialog Window	36
Main Groups of Controls	36
Debugger View Windows	36
Debugger Buttons	37
Resume Execution	38
Interrupt	38
Quit	39
Step Over	39
Step Into	39
Step Out	39
Debugger Scripts Window	40
Accessing Scripts in the Scripts Window	40
Scripts Inside PDF Files	40
Scripts Outside PDF Files	41
Call Stack List	41
Inspect Details Window	42
Details Window Controls	42
Inspecting Variables	43
Watches	44
Breakpoints	44
Starting the Debugger	46
Debugging From the Start of Execution	46
Debugging From an Arbitrary Point in the Script	46
Stepping Through Your Code	47
Exercise: Calculator	47
Calculator	48
Getting Started	49
Debugging a runtime error	50
Another runtime error	51
Known Issues	52
Summary	53
Using Acrobat JavaScript in Forms	55
Creating simple JavaScripts	55
Creating an automatic date field	55
Performing Arithmetic Calculations	56
Assigning a ‘go to page’ action	57
Sending a document or form via e-mail	58
Hiding a field until a condition is met	59
Working with JavaScript actions	60
Working with document level JavaScript actions	61
Creating form fields programmatically	62
Button	64
Check Box	66
Combo Box	67
List Box	70
Radio Button	71
Signature	72
Text	73
A Short Acrobat JavaScript FAQ	75
Where can JavaScripts be found and how are they used?	75
Folder Level JavaScripts	75
Document level	75
Field level	76
How should I name my form fields?	76
How do I use date objects?	77
Converting from a Date to a String	77
Converting from a string to a date	79
Date arithmetic	79
How can I make my document secure?	81
Restricting Access to the Document	81
Restricting Permissions	81
Digital Signatures	81
How can I make restricted Acrobat JavaScript methods available to users?	82
How can I lock a document after a signature field has been signed?	82
How can I make my documents accessible?	83
Document Metadata	83
Short Description	84
Setting Tab Order	84
Reading Order	84
How can I define globals in JavaScript?	84
Making Globals Persistent	85
How can I send form data to an e-mail address?	85
How can I hide a field based on the value of another?	85
How can I query a field value in another open form from the form I'm working on?	85
How can I intercept keystrokes one by one as they occur?	86
How can I build a nested popup menu?	86
How can I construct my own colors?	86
How can I prompt the user for a response in a dialog?	87
How can I fetch an URL from JavaScript?	87
How can I change the hot-help text for a field dynamically?	87
How can I change the zoom factor programmatically?	87
How can I determine if the mouse has entered/left a certain area?	88

Match case Limit results 1 per page

Acrobat JavaScript Debugger

Debugger Scripts Window

Acrobat JavaScript Scripting Guide

Debugger Scripts Window

Scripts are automatically collected from a PDF file open in Acrobat when you open the

debugger dialog. The debugger displays these in the

Scripts

window.

Figure 3.5

shows an

example.

IGURE

3.5

Scripts window

Accessing Scripts in the Scripts Window

To access scripts you want to display, you click the triangle next to an entry in the

Scripts

window to open the next level down. Continue to click triangles to open the next lower

level. Use the scroll bar, if necessary, to view the contents in the window as you open lower

levels. A script icon indicates that a script is defined for an action or function. In

Figure 3.5

, a

function is defined for a mouse-up action on a button-type form named

Button1

. Clicking

on the script icon opens the debugger at the location of the first script statement.

Acrobat JavaScripts can be stored in several places, either inside or outside PDF files. Scripts

that live inside a PDF file are associated with an action of type JavaScript. The following

sections contain lists of possible locations for scripts, inside or outside a PDF file. These

scripts are immediately available for viewing and debugging in with the Acrobat JavaScript

Debugger

Scripts Inside PDF Files

Table 3.3

lists the PDF-file script types that can be displayed in the Scripts window. You can

view and debug these scripts anytime that you open the debugger dialog. You can edit

these scripts from inside the debugger and you can set breakpoints as described in

Breakpoints on page 44

. Changes to scripts do not take effect until the scripts are re-run;

you cannot make changes to a running script.

ABLE

3.3

Scripts inside PDF files

Location

Access

Document level

Advanced > JavaScript > Document JavaScripts