Developing Acrobat Applications Using JavaScript - adobe.com

1 Bc Developing Acrobat Applications Using JavaScript . adobe Acrobat SDK. November 2006 Version 2006 adobe Systems Incorporated. All rights reserved. adobe Acrobat SDK Developing Acrobat Applications Using JavaScript for Microsoft Windows and Mac OS . Edition , November 2006. If this guide is distributed with software that includes an end user agreement, this guide, as well as the software described in it, is furnished under license and may be used or copied only in accordance with the terms of such license. Except as permitted by any such license, no part of this guide may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of adobe Systems Incorporated.

2 Please note that the content in this guide is protected under copyright law even if it is not distributed with software that includes an end user license agreement. The content of this guide is furnished for informational use only, is subject to 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 the informational content contained in this guide. Please remember that existing artwork or images that you may want to include in your project may be protected under copyright law. The unauthorized incorporation of such material into your new work could be a violation of the rights of the copyright owner.

3 Please be sure to obtain any permission required from the copyright owner. Any references to company names and company logos in sample material are for demonstration purposes only and are not intended to refer to any actual organization. adobe , the adobe logo, Acrobat , After Effects, FrameMaker, Illustrator, LiveCycle, Photoshop, PostScript and Reader are either registered trademarks or trademarks of adobe Systems Incorporated in the United States and/or other countries. Apple and Mac OS are trademarks of Apple Computer, Inc., registered in the United States and other countries. JavaScript is a trademark or registered trademark of Sun Microsystems, Inc.

4 In the United States and other countries. Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. All other trademarks are the property of their respective owners. adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to Government End Users. The Software and Documentation are Commercial Items, as that term is defined at 48 , consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 or 48 , as applicable. Consistent with 48 or 48 through , as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein.

5 Unpublished-rights reserved under the copyright laws of the United States. adobe Systems Incorporated, 345 Park Avenue, San Jose, CA. 95110-2704, USA. For Government End Users, adobe agrees to comply with all applicable equal opportunity laws including, if appropriate, the provisions of Executive Order 11246, as amended, Section 402 of the Vietnam Era Veterans Readjustment Assistance Act of 1974 (38 USC 4212), and Section 503 of the Rehabilitation Act of 1973, as amended, and the regulations at 41 CFR Parts 60-1 through 60-60, 60-250, and 60-741. The affirmative action clause and regulations contained in the preceding sentence shall be incorporated by reference.

6 Contents Contents .. 3. List of Examples .. 10. Preface .. 12. What's in this guide? ..12. Who should read this guide? ..12. About the sample Related documentation ..13. 1 Introduction .. 14. Reading the JavaScript for Acrobat API Reference ..15. Object summary ..16. Doc ..16. dbg ..17. SOAP ..18. search ..18. JavaScript 2 Tools .. 21. Using the JavaScript Debugger Opening the console ..22. Executing JavaScript ..22. Formatting Enabling JavaScript ..22. Debugging with the JavaScript Using a JavaScript editor ..24. Specifying the default JavaScript editor ..25. Using an external Additional editor capabilities ..26. Specifying additional capabilities to your editor.

7 26. Saving and closing a file with a syntax Using the Debugger with adobe Reader ..28. Enabling the JavaScript Debugger ..29. 3. adobe Acrobat SDK Contents Developing Acrobat Applications Using JavaScript 4. 2 Tools (Continued). JavaScript Main groups of Debugger View Debugger buttons ..32. Debugger Scripts window ..33. Call Stack list ..35. Inspect details window ..35. Coding styles and breakpoints ..37. Listing breakpoints ..38. Using conditional breakpoints ..38. Starting the Debugger ..38. Final notes ..39. 3 JavaScript Contexts in Acrobat .. 40. The concept of a JavaScript event ..40. About Folder level ..42. Document level ..43.

8 Page Field level ..44. Batch level ..44. Privileged versus non-privileged context ..45. Executing privileged methods in a non-privileged Executing privileged methods through the Executing privileged methods in a certified document ..48. 4 Creating and Modifying PDF Documents .. 49. Creating and modifying PDF Combining PDF Combining and extracting Creating file Cropping and rotating pages ..55. Cropping Rotating Extracting, moving, deleting, replacing, and copying pages ..56. Adding watermarks and Converting PDF documents to XML format ..59. 5 Print Production .. 60. Setting print options ..60. Printing PDF Silent Printing comments and forms.

9 64. Booklet Setting advanced print Specifying output settings ..65. Specifying marks and Setting PostScript Setting font adobe Acrobat SDK Contents Developing Acrobat Applications Using JavaScript 5. 6 Using JavaScript in 67. Forms About PDF Elements of Acrobat Guidelines for creating a new Creating Acrobat form Setting Acrobat form field properties ..70. Field properties ..71. Button fields ..72. Check box fields ..74. Combo box List box Radio button Signature Text Validation Calculation script ..85. Task-based Highlighting required form fields ..86. Making a form Setting the hierarchy of form Creating forms ..88. Positioning form Duplicating form fields.

10 89. Creating multiple form fields ..90. Defining the tabbing order ..91. Defining form field calculation order ..91. Making PDF forms web-ready ..91. Creating a submit button ..92. Creating a reset form Defining CGI export values ..92. Importing and exporting form Emailing completed forms ..93. Use date objects ..93. Date arithmetic ..95. Defining global variables in JavaScript ..96. Enable the global object security policy ..96. Setting and getting a global Deleting global variables ..97. Making global variables persistent ..97. Querying an Acrobat form field value in another open Global object security policy ..98. Intercepting keystrokes in an Acrobat Constructing custom colors.