Adobe ACROBAT 7.0.5 SDK Manual
  1. Manuals
  2. Brands
  3. Adobe Manuals
  4. Software
  5. ACROBAT 7.0.5 SDK
  6. Manual
Adobe ACROBAT 7.0.5 SDK Manual

Adobe ACROBAT 7.0.5 SDK Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

®
®
Adobe
Acrobat
7.0.5
Acrobat SDK User's Guide
July 27, 2005
Adobe Solutions Network — http://partners.adobe.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ACROBAT 7.0.5 SDK and is the answer not in the manual?

Questions and answers

Related Manuals for Adobe ACROBAT 7.0.5 SDK

Summary of Contents for Adobe ACROBAT 7.0.5 SDK

  • Page 1 ® ® Adobe Acrobat 7.0.5 Acrobat SDK User’s Guide July 27, 2005 Adobe Solutions Network — http://partners.adobe.com...
  • Page 2 Adobe Systems Incorporated. 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.

  • Page 3: Table Of Contents

    Adobe Reader-enabled Plug-ins ........
  • Page 4 Choosing an Adobe PDF Settings File ........
  • Page 5 Using the Adobe Dialog Manager (ADM) ........
  • Page 6 The Adobe XML Architecture ........
  • Page 7 Digitally Signing Adobe PDF Documents ........
  • Page 8 Signing Adobe PDF Documents........
  • Page 9 About Adobe PDF layers ........
  • Page 10 Contents Acrobat SDK User’s Guide...

  • Page 11: Preface

    Acrobat Plug-in Guide explains how to use the Acrobat core and extended APIs to write ● plug-ins for Acrobat and Adobe Reader. It describes basic Acrobat development concepts and provides information on upgrading plug-ins from Acrobat 6 to Acrobat 7.

  • Page 12: How This Document Is Organized

    Adobe Dialog Manager Programmer’s Guide and Reference describes how to create ● platform-independent dialog boxes for your plug-in. Developing for Adobe Reader provides an introduction to those portions of the Adobe ● Acrobat Software Development Kit (SDK) that pertain to your development efforts for Adobe Reader.
  • Page 13 Acrobat and XML Forms. Chapter 10, “Rights-enabled PDF Documents, ” describes how to work with PDF ● documents with additional usage rights in Acrobat and Adobe Reader. Chapter 11, “Providing Document Security, ” describes how to use the Acrobat SDK to ●...

  • Page 14: Conventions Used In This Book

    { do something } Placeholders in code AFSimple_Calculate(cFunction, examples cFields) blue Live links to Web pages The Adobe Solutions Network URL is: http://partners.adobe.com/ Live links to sections Using the SDK. within this document Live links to code items Test whether an exists.

  • Page 15: Chapter 1 Getting Started

    ● the functionality provided by Adobe Reader. Acrobat 7.0 is offered in two configurations: – Acrobat 7.0 Standard — Offers all of the Adobe PDF creation and distribution tools in ® Acrobat Elements (see below) and also allows users to more effectively manage document review cycles.
  • Page 16 1,000 seats. There is no public API for Acrobat Elements. What Are the Tools For Creating PDF Files? The Adobe Acrobat family. Adobe Acrobat 7.0 Standard and Professional both include ● ® Acrobat Distiller for creating PDF files from PostScript files created with your favorite applications (including desktop publishing software).

  • Page 17: What Is The Acrobat Sdk

    The Acrobat SDK is a set of tools that help you develop software that interacts with Acrobat technology. The SDK contains header files, type libraries, simple utilities, sample code, and documentation. Using the Acrobat SDK, you can develop software that integrates with Acrobat and Adobe Reader in the following ways: Acrobat JavaScript...

  • Page 18: What's New In Pdf 1.6

    Getting Started What’s New in PDF 1.6? Wh at ’s N ew i n P D F 1 . 6 ? The following features are new in the PDF 1.6 specification. For complete details, see the PDF 1.6 Reference. An enhancement to the syntax of DeviceN color spaces to support NChannel color ●...

  • Page 19: Chapter 2 Technologies Supported By The Acrobat Sdk

    ® http://partners.adobe.com/asn. It has release notes containing UNIX-specific information. Besides the technologies provided by the Acrobat SDK, you can also use the Adobe PDF Library (PDFL) to develop applications that create and manipulate PDF documents but do not interact with Acrobat. The Adobe PDF Library is licensed separately from the Acrobat SDK.

  • Page 20: Acrobat Javascript Contexts

    For more information, see the Acrobat JavaScript Scripting Guide. Plug-ins Plug-ins are dynamically-linked extensions to Acrobat or Adobe Reader. They can hook into the user interface in a number of ways and can register to be called when a variety of events occur in the application.

  • Page 21: Certified Plug-Ins

    Acrobat’s security model. There is a checkbox in the Acrobat and Adobe Reader user interface that can be used to ensure that only certified plug-ins load. This means that other plug-ins will not load. Certified plug-ins can be provided only by Adobe.

  • Page 22: Development Environments

    Technologies Supported by the Acrobat SDK Plug-ins Development Environments Windows Windows developers can develop plug-ins using C and C++ with Visual Studio . NET 2003. There is currently no support for development of plug-ins using managed languages such as C# or VB.NET. However, managed languages are fully supported for use with interapplication communication (IAC) and specifically with the JSObject...
  • Page 23 The Acrobat Viewer (AV) layer, also known as AcroView or AV Model, works with the Acrobat or Adobe Reader application. Its methods allow plug-ins to manipulate components of the Acrobat or Adobe Reader application itself, such as menus and menu items.

  • Page 24: Extended Apis For Plug-Ins

    Technologies Supported by the Acrobat SDK Plug-ins Acrobat Support The Acrobat Support (AS) layer provides platform-independent utility functions and allows plug-ins to override the built-in file-handling mechanisms. Cos Layer The Cos Object System (Cos) layer provides access to the building blocks used to construct documents.

  • Page 25: Interapplication Communication (Iac)

    Windows platforms. Adobe Reader also supports IAC, but does not support OLE on Windows. IAC support allows programs to control Acrobat or Adobe Reader in much the same way a user would. You can also use IAC support to render a PDF file into an external application window instead of the Acrobat window.

  • Page 26: Interapplication Communication Objects

    Acrobat is an OLE server and also responds to a variety of OLE automation messages. You can embed PDF documents into documents created by an application that is an OLE client. Adobe Reader does not support OLE on Windows. For complete descriptions of the Acrobat parameters associated with OLE automation methods, see the OLE automation sections of the Acrobat Interapplication Communication Reference.

  • Page 27: Apple Event Support

    Technologies Supported by the Acrobat SDK Interapplication Communication (IAC) Accessing the JSObject Interface Acrobat 7.0 provides a rich set of JavaScript programming interfaces that are designed to be used from within the Acrobat environment. It also provides a mechanism (known as the JSObject ) that allows external clients to access the same functionality from environments such as VB .NET, Visual C++ .NET and Visual C# .NET.

  • Page 28: Technical Limitations Of Using The Iac Api With Adobe Reader

    There are licensing restrictions on functionality that may be added to Adobe Reader by plug-ins. See http://partners.adobe.com/asn. The Adobe PDF Library The Adobe PDF Library is based on the core technology of the Adobe Acrobat line of products and offers complete functionality for generating, manipulating, rendering, and printing Adobe PDF documents.

  • Page 29: Chapter 3 Deciding Which Acrobat Sdk Technology To Use

    When to Use Interapplication Communication ● Deciding Between Plug-ins and JavaScript ● Samples Provided with the Acrobat SDK ● Getting Started You can develop software that integrates with Acrobat and Adobe Reader in three ways: Acrobat JavaScript ● Plug-ins ● Interapplication Communication (IAC) ●...

  • Page 30: When To Use Interapplication Communication

    “PDF Browser Controls” on page 26 or the Acrobat Interapplication Communication Overview for more details. Acrobat or Adobe Reader must be installed on the end-user’s computer for the PDF O T E Browser Controls to function correctly. You can also use the IAC API to open and view a PDF document. However, when you use the IAC API, no toolbars are displayed;...

  • Page 31: Deciding Between Plug-Ins And Javascript

    ● Manipulate a PDF document, editing and adding content ● Control Acrobat remotely. You cannot remotely control Adobe Reader. ● From the Acrobat Viewer layer, you can use the IAC API to display PDF files in your application’s windows. You can change the control you have over the application’s user...

  • Page 32: General Issues

    Deciding Which Acrobat SDK Technology to Use Deciding Between Plug-ins and JavaScript Subsequent chapters of this document discuss specific tasks you can do using the O T E Acrobat SDK and which technologies you can use to perform those tasks. General Issues The table below lists other general issues that are relevant to deciding between plug-ins and JavaScript.

  • Page 33: What You Can Do With Plug-Ins That You Can't Do With Javascript

    Deciding Which Acrobat SDK Technology to Use Deciding Between Plug-ins and JavaScript What You Can Do with Plug-ins That You Can’t Do with JavaScript In general, plug-ins allow for more direct control over Acrobat than JavaScript. There is a much richer set of APIs that you can use from a plug-in. The following can only be done using a plug-in;...

  • Page 34: Samples Provided With The Acrobat Sdk

    The Acrobat SDK contains a large number of sample applications, plug-ins, and scripts to demonstrate how to use the SDK technologies. Samples are regularly being added to the Acrobat SDK. Please refer to O T E http://partners.adobe.com/links/acrobat for the current complete list of samples available for the Acrobat SDK. Plug-in Samples There are two types of plug-in samples in the Acrobat SDK: complete plug-ins and plug-in snippets.

  • Page 35: Acrobat Javascript Samples

    Deciding Which Acrobat SDK Technology to Use Samples Provided with the Acrobat SDK Acrobat JavaScript Samples JavaScript samples are divided into six categories, each in its own folder in the Acrobat 7.0 SDK/JavaScriptSupport/Samples folder: Outside PDF JavaScript files that live outside an Acrobat file — for example, the code used in JavaScript folders, the console, and batch processes.
  • Page 36 Deciding Which Acrobat SDK Technology to Use Samples Provided with the Acrobat SDK Acrobat SDK User’s Guide...

  • Page 37: Chapter 4 Creating Pdf Documents

    Acrobat product. Acrobat PDFMaker Files created in many applications can be converted directly to Adobe PDF files without leaving the authoring application. The authoring application uses PDFMaker for the conversion and the resulting files are Adobe PDF files.

  • Page 38: Adobe Pdf Printer

    Adobe PDF settings are used to convert the file. Save As or Export Use the Save As or Export command to create an Adobe PDF file from the current file. This method is available in authoring applications such as Adobe InDesign, Adobe Photoshop®, Adobe Illustrator®, and Adobe PageMaker.

  • Page 39: Creating Pdf Documents From An Authoring Application

    Apple Event Support ● Distiller Automation on Windows Using OLE Automation ● Automated, Silent Creation of PDF Documents from Windows ● Choosing an Adobe PDF Settings File ● Automatically Generating Advanced Acrobat Features ● Inserting PostScript Code into a Job ●...

  • Page 40: Apple Event Support

    In addition, certain features of Distiller can be controlled directly through the PostScript language file (see “Choosing an Adobe PDF Settings File” on page 41). Authoring applications that control Distiller should also provide an interface to their users to allow control of font embedding and image compression as well as downsampling in the PDF file.

  • Page 41: Automated, Silent Creation Of Pdf Documents From Windows

    Creating PDF Documents from an Authoring Application Automated, Silent Creation of PDF Documents from Windows In the Acrobat 7.0.5 SDK, there is a new set of APIs that allow you to automate the silent creation of PDF files from an external Windows application.

  • Page 42: Inserting Postscript Code Into A Job

    See Distiller Parameters for more information. Attaching the Native Document to the PDF File Another way that an authoring application can integrate with Acrobat or Adobe Reader is to allow the user access to the original authoring document through the Acrobat user interface.

  • Page 43: Creating Tagged Pdf Documents

    A separate product, Acrobat Distiller Server, can be purchased or licensed from Adobe for server use. Creating Tagged PDF Documents PDF files are well known for representing the physical layout of a document;...

  • Page 44: Adding Structure Data To A Pdf Document

    Creating PDF Documents Creating Tagged PDF Documents Adding Structure Data to a PDF Document Creating a tagged document directly from an authoring application is the best way to make PDF documents accessible to screen readers and reflow correctly on handheld devices. If your PDF document was created without tags, Acrobat can add them.

  • Page 45: Creating Pdf Documents Using Plug-Ins Or Acrobat Javascript

    Creating PDF Documents Creating PDF Documents Using Plug-ins or Acrobat JavaScript Cre at i n g P D F D o c u m e n t s Us i n g P l u g - i n s o r Acro b at Jav a S c r i p t You can use Acrobat and the Acrobat SDK to create a new, empty PDF file and to create a PDF file from supported file types.

  • Page 46: Creating Pdf Files Without Using Acrobat

    Acrobat Capture 3.0.x ● Acrobat Capture 3.0.x is a separate Adobe product designed for the batch conversion of image files to PDF and creating searchable text PDF files from the resulting PDF files. For more information on the Acrobat Capture 3.0.x SDK, see partners.adobe.com/links/acrobat.

  • Page 47: Chapter 5 Working With Pdf Documents

    Working with PDF Documents This chapter details how you can work with PDF documents using the Acrobat SDK. This chapter consists of the following sections: Automating Processes: Opening PDF Documents Silently ● Adding Navigation to PDF Documents ● Manipulating Pages of a PDF File ●...

  • Page 48: Automating Processes: Opening Pdf Documents Silently

    In both cases, bear in mind that PDF files from future versions of Acrobat or other O T E sources could conflict with the current version of Acrobat or Reader without displaying this warning, although Adobe Systems, Inc. makes every effort to avoid such backward compatibility issues. Acrobat SDK User’s Guide...

  • Page 49: Adding Navigation To Pdf Documents

    Working with PDF Documents Adding Navigation to PDF Documents Adding Navigation to PDF Documents This section describes ways that you can add navigation to your PDF file using the Acrobat SDK. Adding and Managing Bookmarks ● Adding and Managing Thumbnails ●...

  • Page 50: Adding And Managing Thumbnails

    Working with PDF Documents Adding Navigation to PDF Documents Adding and Managing Thumbnails Page thumbnails are miniature previews of the pages in a document. You can use page thumbnails in Acrobat to jump quickly to a selected page and to adjust the view of the page.

  • Page 51: Using Actions For Special Effects

    Working with PDF Documents Manipulating Pages of a PDF File Using Actions for Special Effects Thumbnails, bookmarks, links, and other objects have actions associated with them, and you may use Acrobat JavaScript to customize their behavior. For example, you can use them to display messages, jump to destinations in the same document or any other, open attachments, open Web pages, execute menu commands, or perform a variety of other tasks.

  • Page 52: Creating And Editing Page Content

    Working with PDF Documents Creating and Editing Page Content Creating and Editing Page Content Page content is a major component of a PDF file. It represents the visible marks on a page that are drawn by a set of PDF marking operators. The set of marking operators for a page is also referred to as a display list, since it is a list of marking operations that represent the displayed portion of a page.

  • Page 53: Using Document Logical Structure

    Working with PDF Documents Using Document Logical Structure Using Document Logical Structure As discussed in “Creating Tagged PDF Documents” on page 43, you can insert logical structure into a PDF document by creating a tagged PDF document. PDSEdit API provides the ability to add, modify and view this logical structure. For more information, see the Acrobat and PDF Library API Overview.

  • Page 54: Modifying Pdf Documents In Other Ways

    Working with PDF Documents Modifying PDF Documents in Other Ways Modifying PDF Documents in Other Ways You can also use a plug-in or Acrobat JavaScript to modify a PDF document by: Cropping and rotating pages ● Numbering pages ● Adding headers and footers ●...

  • Page 55: Spell-Checking

    Working with PDF Documents Spell-Checking Spell-Checking Acrobat provides a Spelling plug-in that can scan a document for spelling errors. Using any of the Acrobat SDK technologies, you can do the following: Add or remove a dictionary from the list of available dictionaries ●...

  • Page 56: Interacting With Obdc Databases

    Pri nt in g PD F Fi le s Using the Acrobat SDK, you can control the way that Acrobat, Adobe Reader or your external application prints PDF files. Customizing and Automating Printing Using any of the Acrobat technologies, you can customize the way that a PDF document is printed.

  • Page 57: Working With Embedded Fonts

    Working with PDF Documents Working with Embedded Fonts To set more specific parameters for printing without a user interface, you must use the method. Among the parameters that you can set with AVDocPrintPagesWithParams this method are: The printer to be used ●...

  • Page 58: Large Page Sizes In Pdf Documents

    Working with PDF Documents Large Page Sizes in PDF Documents Large Page Sizes in PDF Documents In previous versions of Acrobat, the maximum size of a PDF document was 200 by 200 inches due to the internal use of ASFixed variables for all coordinates.

  • Page 59: Chapter 6 Modifying The User Interface

    Menu items added by plug-ins can have shortcuts (keyboard accelerators). Acrobat and Adobe Reader do not ensure that plug-ins add unique shortcuts, but it is possible for a plug-in to check which shortcuts are already in use before adding its own. Note that the only way to ensure there are no shortcut conflicts is for all plug-ins to check for conflicts before adding their own shortcuts.

  • Page 60: Adding A New Menu

    Modifying the User Interface Modifying the Toolbar Adobe keeps a registry of plug-in menu item names to help avoid conflicts between plug- ins. For more information on registering and using plug-in prefixes, see the Acrobat SDK Plug-in Guide. Adding a New Menu...

  • Page 61: Using The Adobe Dialog Manager (Adm)

    Us i n g t h e Ado b e D ia l o g M a n a g e r (AD M ) The Adobe Dialog Manager (ADM) is a cross-platform API for implementing dialog interfaces for Adobe applications such as Acrobat, Adobe Reader, Photoshop, Illustrator, and After Effects.

  • Page 62: Adm Objects

    Modifying the User Interface Using the Adobe Dialog Manager (ADM) OK, Cancel, and Other button ● You can also create containers or frames to work with sets of controls. The following is an example of a cluster of several items: ADM Objects ADM user interfaces are built from ADM user interface objects.

  • Page 63: Using Adm From Acrobat Javascript

    ADM contains a series of suites, each of which implements different functionality. Each suite has its own header file that declares its functions, data types, constants, and so on. For more informaton, see the Adobe Dialog Manager Programmer’s Guide and Reference. Macintosh Issues Carbon is a set of programming interfaces that can be used to build Mac OS X applications that also run on Mac OS 8 and 9 (versions 8.1 and later).

  • Page 64: Customizing Acrobat Help

    Plug-ins can set values in the preferences file (using the method) AVAppSetPreference to prevent the Acrobat or Adobe Reader “About” box and/or splash screen from appearing before displaying the first document. These changes take effect the next time Acrobat or Adobe Reader is launched.

  • Page 65: Customizing The How-To Panel

    Modifying the User Interface Customizing Acrobat Help Customizing the How-To Panel The core API provides several methods to customize the How-To panel from a plug-in. Use AVAppRegisterHowToPanel to register an HTML or XML file to appear in the How-To panel. opens the How-To panel and fills it with the specified AVAppAutoShowHowToPanel panel’s contents, if that panel’s AutoShow attribute is...
  • Page 66 Modifying the User Interface Customizing Acrobat Help Acrobat SDK User’s Guide...

  • Page 67: Chapter 7 Using Online Collaboration And Annotations

    Using Online Collaboration Acrobat provides a platform for the development of a variety of collaborative review systems to fit various needs. A complete, integrated Acrobat and Adobe PDF online collaboration solution includes the following major elements: Adobe PDF documents created from source documents authored in various word ●...

  • Page 68: How Fdf Files Are Used

    Using Online Collaboration and Annotations Using Online Collaboration How FDF Files Are Used FDF (Forms Data Format) is an Acrobat-specific format used to store form data and other information from a PDF file. An FDF file that is created during a comment upload contains only the reviewer’s comments and a reference to the reviewed PDF file.

  • Page 69: Using Annotations In Document Workflows

    Using Online Collaboration and Annotations Using Annotations in Document Workflows Using Annotations in Document Workflows An annotation associates an object such as a note, sound, or movie with a location on a page of a PDF document, or provides a way to interact with the user via the mouse and keyboard.

  • Page 70: Annotations And Plug-Ins

    Using Annotations in Document Workflows Annotations and Plug-ins PDAnnot class is the abstract superclass for all annotations (see the PDF Reference). Acrobat and Adobe Reader have two built-in annotation classes: PDTextAnnot . Plug-ins can add movie, Widget (form field), and other annotation types. PDLinkAnnot You can define new annotation subtypes by creating new annotation handlers (see “Creating New Annotation Types”...

  • Page 71: Using Stamps In Approval Workflows

    Using Online Collaboration and Annotations Using Stamps in Approval Workflows Using Stamps in Approval Workflows Use the Stamp tool to apply a stamp, dynamic stamp, or custom stamp to a PDF document. A stamp can be created from a set of predefined stamps, dynamically created using system and identity information, or customized from PDF files or common graphic formats.
  • Page 72 Using Online Collaboration and Annotations Using Stamps in Approval Workflows Acrobat SDK User’s Guide...

  • Page 73: Chapter 8 Xml And The Acrobat Sdk

    Managing XML-based Information ● The Adobe XML Architecture The Adobe XML architecture leverages the capabilities of XML and PDF to support a variety of business applications, while offering connectivity to systems through a variety of industry-standard and Adobe technologies. Acrobat SDK User’s Guide...

  • Page 74: Xml Forms

    Static XML forms were supported in Acrobat 6, and dynamic XML forms are now supported in Acrobat 7. Both types are created using Adobe Designer. A static form presents a fixed set of text, graphics, and field areas at all times. Dynamic XML forms are created by dividing a form into a series of subforms and repeating subforms.
  • Page 75 DNS Service Discovery. All of this enables the integration of PDF files into existing workflows by binding Adobe XML forms to schemas, databases, and web services. These workflows include the ability to share comments remotely or invoke web services through form field actions.

  • Page 76: Converting Pdf Documents To Xml Format

    ID used to save in the desired format. For XML, the conversion ID is ”com.adobe.acrobat.xml-1-00”. For more information, see the Acrobat JavaScript Scripting Guide and the Acrobat JavaScript Scripting Reference.

  • Page 77: Managing Xml-Based Information

    XML and the Acrobat SDK Managing XML-based Information For more information, including a sample Mapping Table that demonstrates the basic operation of the SaveAsXML processing, see Using the SaveAsXML Plug-in. Managing XML-based Information Acrobat JavaScript provides support for XML-based information generated within workflows by providing an XML object, which represents an XML document tree that can be manipulated via the XFA Data DOM.
  • Page 78 XML and the Acrobat SDK Managing XML-based Information Acrobat SDK User’s Guide...

  • Page 79: Chapter 9 Forms And The Acrobat Sdk

    XML forms rather than Acrobat forms. XML Forms A form is derived from a form design that you create using Adobe LiveCycle Designer. The form design specifies a set of layout, presentation rules, and data capture rules, including calculating values based on user input.

  • Page 80: Acrobat Forms

    With Acrobat forms, you can author form fields and retrieve data from those form fields. For Adobe Reader, the Forms plug-in does not allow form authoring, but allows users to fill in data and print Acrobat forms. The Adobe Reader Forms plug-in also does not allow users to save data to the local hard disk.

  • Page 81: Forms Workflows

    Forms and the Acrobat SDK Forms Workflows Fo r m s Wo r k f l ows There are three basic workflows for forms: Fill and Print Forms are filled in on the screen and then printed out. They are then returned by traditional methods such as fax or postal mail.

  • Page 82: Guidelines For Creating A New Form

    G u i d e l i n e s fo r C re at i n g a N ew Fo r m Creating a new form, whether using Adobe LiveCycle Designer or programmatically using Acrobat JavaScript, requires you to consider specific issues. For guidelines, see the Acrobat JavaScript Scripting Guide.

  • Page 83: The Forms Api

    Chapter 10, “Rights-enabled PDF Documents”. Both Acrobat and Adobe Reader allow Web designers to send data from the form back to a Web server. The Forms API uses the object, which is an opaque object representing a field in PDField an Acrobat form.

  • Page 84: Xml Forms And The Acrobat Sdk

    For more information, see the Acrobat JavaScript Scripting Guide. Punchcard/Barcode Form Fields With Adobe LiveCycle Designer, you can add interactive barcode form fields for various identification purposes, such as product inventory. The bars and characters of interactive barcode fields change to encrypt the data that is entered into other associated form fields.

  • Page 85: Collecting Data From Completed Forms

    Forms and the Acrobat SDK Collecting Data from Completed Forms Collecting Data from Completed Forms XML and XDP Formats You can save your form data in pure XML format, or, to take advantage of the rich functionality offered by the XFA plug-in, you can save your forms in the XML Data Package format (XDP).

  • Page 86: Xml Form Templates

    Forms and the Acrobat SDK XML Form Templates XML Form Templates Acrobat JavaScript defines a Template object that supports interactive form architectures. In this context, a Template is a named page within a PDF document that provides a convenient format to automatically generate and manipulate a large number of form fields. These pages contain visibility settings, and can be used to spawn new pages containing identical sets of form controls to those defined within the template.

  • Page 87: Chapter 10 Rights-Enabled Pdf Documents

    When creating a PDF document, it is possible to assign it special rights that enable users of Adobe Reader to fill in forms, participate in online reviews, and attach files. Adobe LiveCycle Reader Extensions may be used to activate additional functionality within Adobe Reader for a particular document, thereby enabling the user to save, fill in, annotate, sign, certify, authenticate, and submit the document.

  • Page 88: Differences Between Usage Rights And Reader Enabling

    For more information, see the Acrobat JavaScript Scripting Guide. Differences between Usage Rights and Reader Enabling You may not develop an Adobe Reader plug-in without approval from Adobe. You must use Adobe’s web-based application to describe your plug-in and submit information to Adobe.

  • Page 89: Creating Rights-Enabled Documents

    PDF documents can be “rights-enabled” using Adobe LiveCycle Reader Extensions . Developers cannot programmatically rights-enable a PDF file. During the design process, a PDF document may be created through the usage of Adobe LiveCycle Designer, Adobe LiveCycle Forms, or Adobe Document Server. The document creator can assign appropriate usage rights using Adobe LiveCycle Reader Extensions.

  • Page 90: Applying And Validating Additional Usage Rights

    Professional are disabled for documents having Reader Extensions. This ensures that the user cannot inadvertently invalidate the additional usage rights in a document under managed review before passing the document on to an Adobe Reader user for further commenting. For complete details, see the Acrobat JavaScript Scripting Guide and the Acrobat SDK Plug-in Guide.

  • Page 91: Chapter 11 Providing Document Security

    To save security settings for later use, you can create a security policy that stores security settings. This chapter focuses on how to use the Acrobat 7.0.5 SDK for security. For O T E information on how to view or modify security using Acrobat 7.0 Professional or Acrobat 7.0 Standard, see the online help for each product.

  • Page 92: Encryption And Decryption

    All objects, except for the encryption dictionary (which contains the security handler’s private data), are encrypted using the RC4 algorithm that Adobe licenses from RSA Data Security, Inc. Plug-ins may not substitute another encryption scheme for RC4.

  • Page 93: Obtaining A Digital Id From A Third Party

    Providing Document Security Digital IDs and Certificates digital signature and certificate match the signer’s digital ID. Adobe Acrobat includes one handler that has access to trusted certificates in a number of different locations. The locations include Microsoft’s cryptographic store used for Windows security, PKCS#12 encryption, which is a standard encryption format, and PKCS#11 encryption, which is used on smart cards.

  • Page 94: Security Handlers

    You cannot create a custom security handler using Acrobat JavaScript. A custom security handler can use Acrobat or Adobe Reader’s built-in dialog boxes for entering passwords and for changing permissions.

  • Page 95: Security Handlers And Acrobat Javascript

    The Adobe.PPKLite security handler, supporting signature and encryption, on Windows, ● provides directory access through the Microsoft Active Directory Scripting Interface (ADSI). The Adobe.AAB security handler provides a local address book and support for directory ● operations. Acrobat SDK User’s Guide...

  • Page 96: Digitally Signing Adobe Pdf Documents

    JavaScript enabled in general. In Acrobat 7.0, encryption using Standard security is possible using predefined policies. Also, in Acrobat 7.0, the Adobe.APS handler can be used for encryption via the encryptUsingPolicy method. This handler also makes a directory available via the directory services, but as no certificates are returned from this directory, it is of limited general use.

  • Page 97: Certifying Pdf Documents

    An organizational policy is created by an Adobe LiveCycle Policy Server administrator ● and is stored on a policy server to be shared by a group of users. Adobe Policy Server controls access to PDF documents and auditing events as defined by the security policy.

  • Page 98: Using Adobe Policy Server

    PDF documents. Adobe Policy Server can be configured to run with LDAP, Adobe Document Server, and other enterprise systems. Policies provided by Adobe Policy Server are stored on the server and can be refreshed from the server. You must log into Adobe Policy Server to use these server policies.

  • Page 99: Document Rights

    Document Rights Document R i ghts By including additional usage rights in a PDF document, you can invite Adobe Reader 7.0 users to participate in an email-based document review. Additional usage rights, such as commenting rights, are document-specific and can be added to any PDF document except forms when you initiate an email-based or browser-based review.
  • Page 100 Providing Document Security Document Rights Acrobat SDK User’s Guide...

  • Page 101: Chapter 12 Working With Metadata

    The set of standard metadata items is organized into schemas, each of which represents a set of properties from a particular application or industry standard. The schemas, as well as the physical representation, are defined by Adobe’s Extensible Metadata Platform (XMP) (see “Extensible Metadata Platform (XMP)”...

  • Page 102: Document Information Dictionary

    Extensible Metadata Platform (XMP) Adobe’s Extensible Metadata Platform (XMP) is a labeling technology that allows you to embed metadata into the file itself. With XMP, desktop applications and back-end publishing systems gain a common method for capturing, sharing, and leveraging this valuable metadata —...

  • Page 103: Accessing Xmp Metadata Using Acrobat Javascript

    Info dictionary, as well as properties that are not in the Info dictionary. The term “XAP” refers to an early internal code name for Adobe’s Extensible O T E Metadata Platform (XMP). For more information on this protocol, see the Adobe XMP Specification.

  • Page 104: Searching Metadata

    Working with Metadata Searching Metadata Many namespaces, keywords, and related names in this document are prefaced with O T E the string “ ”, which was an early internal code name for XMP metadata. These names are retained for compatibility. The XMP Toolkit consists of two parts: MetaXAP manages the metadata for a managed resource such as an application ●...

  • Page 105: Creating Object Data

    PostScript file directly, or modify the authoring application to generate the appropriate pdfmarks in the PostScript stream. For more information, see “Choosing an Adobe PDF Settings File” on page 41 , the pdfmark Reference Manual., and the PDF Reference.
  • Page 106 Working with Metadata Object Data Acrobat SDK User’s Guide...

  • Page 107: Chapter 13 Searching And Indexing

    The Acrobat Search plug-in allows users to perform text searches in PDF documents. It adds menus, menu items, toolbar buttons, and a Search panel to the Acrobat or Adobe Reader. You can communicate with the Search plug-in via its plug-in API, via IAC (DDE or Apple events) or via Acrobat JavaScript’s...

  • Page 108: Search Options

    Searching and Indexing The Acrobat Search Plug-in Search Options Using the Acrobat JavaScript Search object’s properties and using SearchWordOptions flags with the Search API methods from a plug-in, you can specify the scope and search options for your search. You can set the scope of the search to be one or more of the following: Document text ●...

  • Page 109: Indexing Pdf Documents

    Searching and Indexing Indexing PDF Documents When creating a replacement search plug-in for Acrobat, you must decide what indexes your search plug-in will use. You can either create your own indexes (see “Extracting and Highlighting Text”) or search the Lextek indexes created by the Acrobat 7 Catalog plug-in. Indexing PDF Documents You can use the Acrobat SDK to create a full-text index of a set of PDF documents.
  • Page 110 Searching and Indexing Indexing PDF Documents Acrobat SDK User’s Guide...

  • Page 111: Chapter 14 Accessibility

    Accessibility Acrobat and the Acrobat SDK provide extensive support for accessibility of documents to visually-impaired users. This chapter consists of the following sections: Accessibility Overview ● Optimizing the Accessibility of PDF Documents ● Making Forms Accessible ● Annotations and Accessibility ●...

  • Page 112: Optimizing The Accessibility Of Pdf Documents

    Accessibility Optimizing the Accessibility of PDF Documents Optimizing the Accessibility of PDF Documents If a PDF document is untagged, you can convert it to a tagged PDF using Acrobat Professional. Acrobat Standard provides only minimal support tagging and no way to review or O T E repair accessibility problems.

  • Page 113: Setting Tab Order

    Acrobat through assistive technologies, such as screen readers and screen magnifiers. The Acrobat 7.0.5 SDK adds a new annotation accessibility API for the generalized interface between annotations and accessibility so that new and custom annotation types can be supported more easily and reliably.

  • Page 114: Microsoft's Active Accessibility (Msaa) Interface

    Accessibility Microsoft’s Active Accessibility (MSAA) Interface You can enable this option using Acrobat JavaScript’s doc object’s encryptForRecipients method. This method allows you to control whether content can be extracted for use by applications that, for example, read text aloud. For more information, see the Chapter 11, “Providing Document Security”.

  • Page 115: Chapter 15 Working With Pdf Layers

    Working With PDF Layers Adobe PDF layers are components of content that may occupy the same physical space as other components. Multiple components may be visible or invisible depending on their settings, and may be used to support the display, navigation, and printing of layered PDF content by various applications.

  • Page 116: Creating Layered Pdf Files

    Working With PDF Layers Creating Layered PDF Files Creating Layered PDF Files The PDFMakers for several engineering applications, including Microsoft Visio and AutoCad, automatically generate the necessary ProcSets to create layered PDF documents. Third-party developers must insert OC ProcSet information into the PostScript stream. For more details, see “Creating PDF Documents from an Authoring Application”...

  • Page 117: Working With Layers From A Plug-In

    Working With PDF Layers Working with Layers from a Plug-in Wo r k i n g w i t h L ayer s f ro m a P l u g - i n object represents an optional-content group. This corresponds to a PDF OCG PDOCG dictionary representing a collection of graphic objects that can be made visible or invisible.
  • Page 118 Working With PDF Layers Working with Layers from a Plug-in Acrobat SDK User’s Guide...

  • Page 119: Index

    Adobe LiveCycle Designer 79, 84, 89 PDFEdit 23 Adobe LiveCycle Document Security 16 PDSEdit 23 Adobe LiveCycle Forms 89 platform-specific methods 24 Adobe LiveCycle Reader Extensions 16, 87, 89 Cos layer 24 Adobe Policy Server 16, 92, 98 cross-platform compatibility 32 Adobe Reader enabling 88...
  • Page 120 Index dictionary 55 templates 86 digital ID 92 web-ready 84 digital signature 96 workflows 81 Digital Signature Plug-in 24 XDP 85 Distiller 39 XFDF 85 Apple events 40 Forms API 83 Distller Forms Plug-in 24 OLE Automation 40 distribution 32 DNS-SD 75 handlers addRecipientListCryptFilter 98...
  • Page 121 53 Microsoft Outlook 37 PDSEdit 23, 53, 112 Microsoft PowerPoint 37 Plug-in 19 Microsoft Project 37 plug-ins Microsoft Publisher 37 Adobe Reader-enabled 21 Microsoft Visio 37 certified 21 Microsoft Word 37 cross-platform compatibility 32 MSCAPI 94 installation 32 scope 32...
  • Page 122 Index attachments 108 custom 107 watermarks 54 metadata 108 Weblink Plug-in 25 object data 108 workflows XMP 108 forms 81 security 91 accessibility 113 security handlers 94 Security Policies 97 XDP 85 snippets 52 XFDF 85 SOAP 74, 84 XML 73 Spelling 55 architecture 73 Spelling Plug-in 25...

This manual is also suitable for:

Acrobat sdkAcrobat 7.0.5

Table of Contents