c# save pdf : Convert word pdf bookmarks control application system web page azure winforms console AcroJSGuide5-part352

Acrobat JavaScript Scripting Guide
51
Acrobat JavaScript Tools
Debugger Buttons
2
Interrupt
The Interrupt button halts execution of the current script. When clicked, it appears in red, 
which indicates that it has been activated and causes execution to stop at the beginning of 
the next script that is run. If this occurs, the Interrupt button is automatically deactivated 
and returns to its green color. It must be activated again in order to interrupt another script.
Quit
The Quit button terminates the debugging session and closes the debugger.
Step Over
The Step Over button executes a single instruction, and if it is a function call, it executes 
the entire function in a single step, rather than stepping into the function. For example, the 
position indicator (yellow arrow) in the debugger is to the left of a function call, as shown 
below in Figure 2.11:
F
IGURE
2.11
Position Indicator at a Function Call
Excecution is currently halted before the call to 
callMe()
. Assuming that there are no 
errors or breakpoints in 
callMe()
, clicking Step Over executes the entire 
callMe()
function, and advances the position indicator to the next script instruction following the 
function call. 
If the statement at the position indicator does not contain a function call, Step Over simply 
executes that statement.
Step Into
The Step Into button executes the next statement, and if it is a function call, it proceeds to 
the first statement within the function. Refer again to Figure 2.11. Clicking Step Into at this 
point advances the position indicator to the first statement within the 
callMe()
function. 
N
OTE
:
Be aware that it is not possible to step into native functions, since they have no 
JavaScript implementation. This applies to Acrobat native functions as well as core 
JavaScript functions.
Convert word pdf bookmarks - add, remove, update PDF bookmarks in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your C# Project with Rapid PDF Internal Navigation Via Bookmark and Outline
creating bookmarks in pdf documents; bookmarks pdf files
Convert word pdf bookmarks - VB.NET PDF bookmark library: add, remove, update PDF bookmarks in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Empower Your VB.NET Project with Rapid PDF Internal Navigation Via Bookmark and Outline
how to create bookmarks in pdf file; pdf bookmark editor
Acrobat JavaScript Tools
Debugger Scripts Window
2
52
Acrobat JavaScript Scripting Guide
Step Out
The Step Out button executes the remaining code within the current function call and 
stops at the instruction immediately following the call. This button provides a convenient 
means of eliminating cumbersome, stepwise execution of functions that do not contain 
bugs. If you are not inside a function call and there are no errors, the Step Out button 
continues executing code to the end of the current script or until a breakpoint is 
encountered.
Debugger Scripts Window
All scripts associated with a PDF file are available in the debugger dialog. The debugger 
displays these in the Scripts window (see Figure 2.12 below for an example).
F
IGURE
2.12
Scripts window
Accessing Scripts in the Scripts Window
To display the content a script, click the triangle to its left in the Scripts window. Each 
triangle opens the next level in the containment hierarchy. A script icon indicates the 
lowest level, which means that the code for the given function is available. As shown above 
in Figure 2.12, a function has been defined for a mouse-up action on a button named 
Button1
. Click on the script icon to display its code.
Acrobat JavaScripts can be stored in several places, which may be either inside or outside 
PDF files. The following sections describe their possible locations.
VB.NET PDF File Compress Library: Compress reduce PDF size in vb.
Bookmarks. Comments, forms and multimedia. Convert smooth lines to curves. VB.NET Demo Code to Optimize An Exist PDF File in Visual C#.NET Project.
create pdf with bookmarks from word; how to bookmark a pdf file
C# PDF File Split Library: Split, seperate PDF into multiple files
Split PDF file by top level bookmarks. The following C# codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
create pdf bookmarks from word; bookmark pdf acrobat
Acrobat JavaScript Scripting Guide
53
Acrobat JavaScript Tools
Debugger Scripts Window
2
Scripts Inside PDF Files
Table 2.5 below lists the types of scripts contained in PDF files. These can be accessed from 
the Scripts window within the debugger dialog. You can edit them from inside the 
debugger, and set breakpoints as described in Breakpoints on page 58. 
N
OTE
:
Changes to scripts do not take effect until the scripts are re-run; changes cannot be 
applied to a running script.
Form Editing mode — To switch to form editing mode, use the Acrobat Advanced Editing 
toolbar. If it is not visible, select Tools > Advanced Editing > Show Advanced Editing 
Toolbar. You may want to dock this toolbar, as you will use it frequently.
T
ABLE
2.5
Scripts inside PDF files
Location
Access
Document level
Advanced > JavaScript > Document JavaScripts
Document actions Advanced > JavaScript > Set Document Actions
Page actions
Click the page on the Pages tab; select Options > Page Properties 
Forms
Double-click the form object in form editing mode (see below) to 
bring up the Form Properties dialog
Bookmarks
Click the bookmark on the Bookmarks tab; select Options > 
Bookmark Properties
Links
Double-click the link object in form editing mode to bring up the 
Link Properties dialog
VB.NET PDF File Split Library: Split, seperate PDF into multiple
Demo Code in VB.NET. The following VB.NET codes explain how to split a PDF file into multiple ones by PDF bookmarks or outlines.
convert word to pdf with bookmarks; add bookmarks pdf
C# PDF File Compress Library: Compress reduce PDF size in C#.net
Bookmarks. Comments, forms and multimedia. Hidden layer content. Convert smooth lines to curves. Flatten visible layers. C#.NET DLLs: Compress PDF Document.
creating bookmarks in pdf from word; bookmark template pdf
Acrobat JavaScript Tools
Debugger Scripts Window
2
54
Acrobat JavaScript Scripting Guide
Scripts Outside PDF Files
Scripts outside of Acrobat are also listed in the Scripts window and are available for 
debugging in Acrobat. Table 2.6 lists these script types and how to access them. 
Folder-level scripts normally can be viewed and debugged but not edited in Acrobat. 
Console and batch processing scripts are not visible to the debugger until they are 
executed. For this reason, you cannot set breakpoints prior to executing these scripts. You 
can access the scripts either using the Debug From Start option or by using the 
debugger
keyword. See Starting the Debugger for details.
T
ABLE
2.6
Scripts outside PDF files
Location
Access
Folder level
Stored as JavaScript (
.js
) files in the 
App
or 
User
folder areas
Console
Typed and evaluated in the console window
Batch
Choose Advanced > Batch Processing 
C# PDF Convert to HTML SDK: Convert PDF to html files in C#.net
it extremely easy for C# developers to convert and transform document file, converted by C#.NET PDF to HTML all the original anchors, links, bookmarks and font
convert word pdf bookmarks; excel print to pdf with bookmarks
XDoc.Word for .NET, Advanced .NET Word Processing Features
Create Word from PDF; Create Word from OpenOffice (.odt); More about Word SDK Word Export. Convert Word to PDF; Convert Word to HTML5; Convert Word to Tiff; Convert
creating bookmarks pdf; adding bookmarks to a pdf
Acrobat JavaScript Scripting Guide
55
Acrobat JavaScript Tools
Call Stack List
2
Call Stack List
To the right of the debugger control buttons is the Call Stack drop-down list which 
displays the currently executing function and its associated state within the current set of 
nested calls. An example is shown below in Figure 2.13. When the debugger has been used 
to suspend execution at a given statement, the call stack displays text indicating the 
current function call (stack frame). Each entry shows the current line number and function 
name. The most recent stack frame is displayed at the top of the Call Stack drop-down list. 
To inspect the local variables of a particular frame in the stack, click on that entry. They 
appear in the Inspect details window immediately below the call stack list, as shown below 
in Figure 2.13.
F
IGURE
2.13
Call stack
You may select any function in the call stack. Doing so selects that stack frame, and its 
location is shown in the Inspect details window. When Local Variables is selected in the 
Inspect drop-down list, the variables specific to that active frame are displayed in the 
Inspect details window.
C# Word - Convert Word to HTML in C#.NET
VB.NET How-to, VB.NET PDF, VB.NET Word, VB toolkit SDK, preserves all the original anchors, links, bookmarks and font C#: Convert Word document to HTML5 files.
how to add a bookmark in pdf; how to bookmark a pdf document
.NET PDF SDK - Description of All PDF Processing Control Feastures
Full page navigation, zooming & rotation; Outlines, bookmarks, & thumbnail display; PDF Export. Convert PDF to Word (.docx); Convert PDF to HTML; Convert PDF to
add bookmarks to pdf online; how to add bookmarks to pdf document
Acrobat JavaScript Tools
Inspect Details Window
2
56
Acrobat JavaScript Scripting Guide
Inspect Details Window
The Inspect details window is located to the right of the Scripts window and below the 
Call Stack. Its purpose is to help you inspect the values of variables, customize the way in 
which variables are inspected (setting watches), and obtain detailed information about 
breakpoints.
Inspect Details Window Controls
The three buttons at the bottom right of the Inspect details window, shown in Figure 2.14 
below, can be used to edit, create, or delete items. The Edit, New, and Delete buttons 
become active when items in the Inspect drop-down list are selected.
F
IGURE
2.14
Inspect details window button controls
New Delete
Edit
Acrobat JavaScript Scripting Guide
57
Acrobat JavaScript Tools
Inspect Details Window
2
Inspecting Variables
The Inspect details window is a powerful tool that you can use to examine the current state 
of JavaScript objects and variables. It enables you to inspect any objects and properties in a 
recursive manner within the current stack frame in the debugging session.
To inspect a variable, select Local Variables from the Inspect drop-down list, which 
displays a list of variable and value pairs in the Inspect details window. To place a value in a 
variable, highlight the variable in the details window (this activates the Edit button). Click 
the Edit button. An Edit Variable dialog appears, allowing you to enter a new value for the 
variable as shown below in Figure 2.15
A triangle next to a name indicates that an object is available for inspection. If you would 
like to view its properties, click the triangle to expand the object.
F
IGURE
2.15
Local variable details
Watches
The Watches list enables you to customize how variables are inspected. Watches are 
JavaScript expressions evaluated when the debugger encounters a breakpoint or a step in 
execution. The Watches list provides you with the ability to edit, add, or delete watches 
using the three buttons just below the Inspect details window. All results are displayed in 
the Inspect details window in the order in which they were created.
To set a watch, select Watches from the Inspect drop-down list. Click the New button, and 
a dialog prompts you for the JavaScript variable or expression to be evaluated. 
To change the value of a watch, select the watch from the list. Click the Edit button, which 
displays a dialog prompting you to specify a new expression for evaluation. To delete a 
watch, select it from the Inspect drop-down list and click the Delete button.
Acrobat JavaScript Tools
Inspect Details Window
2
58
Acrobat JavaScript Scripting Guide
Breakpoints
The Breakpoints option in the Inspect drop-down list enables you to manage program 
breakpoints, which in turn make it possible to inspect the values of local variables once 
execution is halted. A breakpoint may be defined so that execution halts at a given line of 
code, and conditions may be associated with them (see Using Conditional Breakpoints).
When a breakpoint is reached, JavaScript execution halts and the debugger displays the 
current line of code. 
To add a breakpoint, click on the gray strip to the left of the code in the script view, which 
should cause a red dot to appear. The lines at which breakpoints are permitted have small 
horizontal lines immediately to their left in the gray strip. To remove the breakpoint, click 
on the red dot, which should subsequently disappear. 
Coding Styles and Breakpoints
Placement of the left curly brace (
{
) in a function definition is a matter of style. 
Style 1: Place the left curly brace on the same line as the function name, for example,
function callMe() { // curly brace on same line as function name
var a = 0;
}
Style 2: Place the left curly brace on a separate line, for example
function callMe()
{ // curly brace is on a separate line
var a = 0;
}
If you would like to set a breakpoint at the function heading, use Style 1. Note that the 
Acrobat JavaScript debugger does not set a breakpoint at the function heading for Style 2. 
It is only possible to set a breakpoint from the line of code containing the left curly brace. 
This is illustrated below in Figure 2.16. It is possible to set the breakpoint on the line below 
the function heading for 
callMe()
, and on the line containing the function heading for 
testLoop()
. Setting a breakpoint at a function heading causes execution to stop at the 
first statement within the function. 
F
IGURE
2.16
Setting a Breakpoint at a Function Heading
Acrobat JavaScript Scripting Guide
59
Acrobat JavaScript Tools
Starting the Debugger
2
Listing Breakpoints
To view the list of all breakpoints set for the debugging session, select the Breakpoints 
option from the Inspect drop-down list. You may edit and delete breakpoints using the 
button controls just beneath the Inspect details window, as shown above in Figure 2.14.
Using Conditional Breakpoints
A conditional breakpoint causes the interpreter to stop the program and activate the 
debugger only when a specified condition is true. Conditional breakpoints are useful for 
stopping execution when conditions warrant doing so, and streamline the debugging 
process by eliminating needless stepwise execution. For example, if you are only interested 
in debugging after 100 iterations in a loop, you can set a breakpoint that only becomes 
active when the looping index reaches the value of 100.
The condition is a JavaScript expression. If the expression evaluates to 
true
, the 
interpreter stops the program at the breakpoint. Otherwise, the interpreter does not stop 
the program. An unconditional breakpoint, the default, always causes the interpreter to 
stop the program and to activate the debugger when it reaches the breakpoint, because its 
condition is always set to 
true
To change a breakpoint condition, select Breakpoint from the Inspect drop-down list and 
click Edit. A dialog appears, prompting you to change the breakpoint condition.
Starting the Debugger
There are four ways to invoke the Acrobat JavaScript Debugger. Two of these ways begin 
the debugging session from the start of execution, and the other two begin the session 
from a specified line of code.
Debugging From the Start of Execution
There are two ways to start the debugger from the start of execution. In either case, use the 
Step Into button to proceed with the debugging session.
Debug From Start
Choose Advanced > JavaScript and, if the option is not already checked, click on Debug 
From Start.
This option causes the debugging session to begin at the start of execution of any new 
script.
N
OTE
:
Debug From Start does not turn off automatically. Be sure to turn off this option 
when you have finished debugging, otherwise it continues to stop on every new 
script you execute in Acrobat.
Acrobat JavaScript Tools
Exercise: Calculator
2
60
Acrobat JavaScript Scripting Guide
Click Interrupt
Open the debugger window and click the Interrupt button, which displays in red. At this 
point, performing any action that runs a script causes execution to stop at the beginning of 
the script.
Unlike Debug From Start, the Interrupt button is automatically deactivated after being 
used. To stop at the beginning of a new script, you must reactivate it by clicking it again.
Debugging From an Arbitrary Point in the Script
Define a Breakpoint
To start debugging from a specific point in your script, you can set a breakpoint. See 
Breakpoints for details on how to set a breakpoint. 
Using the debugger keyword
You can also insert the 
debugger
keyword in any line of your code to stop execution and 
enter the debugger when that particular line is reached. 
N
OTE
:
Breakpoints created using the 
debugger
keyword are not listed in the Inspect 
details window when you select Breakpoints from the Inspect drop-down list.
Exercise: Calculator
N
OTE
:
To complete the following exercises, unzip the file 
TestDebugger.zip
and open 
Calc.pdf
.
In this exercise, you will set breakpoints in a script and create watches to view how a 
variable changes as the script executes. At the end of this exercise you will be able to:
Start the debugger from a location within a script.
Interpret the contents of the Inspect details window.
Create, edit, and delete watches.
Set and clear breakpoints.
Use the debugger buttons to control how the interpreter executes the code in the script.
Calculator
Calc.pdf
uses document-level and form field-level scripts to simulate the behavior of a 
simple calculator. The keypad consists of numeric and function keys, the period (.), the 
equals sign (=), and Cancel (C) and Cancel Entry (CE) keys. 
Documents you may be interested
Documents you may be interested