Adobe acrobat 7.0.5 sdk User Manuals

Table of Contents

• Acrobat SDK User’s Guide

  1
• Adobe® Acrobat® 7.0.5

  1
• Contents

  3
• Preface

  11
  • Description

    11
  • Audience

    11
  • Resources and Samples

    11
  • How This Document Is Organized

    12
  • Conventions Used in This Book

    14
• Getting Started

  15
  • What Is Acrobat?

    15
    • What is the Acrobat Family?

      15
    • What Are the Tools For Creating PDF Files?

      16
    • Related Adobe Technologies

      16
  • What Is the Acrobat SDK?

    17
  • What’s New in PDF 1.6?

    18
• Technologies Supported by the Acrobat SDK

  19
  • Acrobat JavaScript

    19
    • Acrobat JavaScript Objects

      19
    • Acrobat JavaScript Contexts

      20
  • Plug-ins

    20
    • Certified Plug-ins

      21
    • Adobe Reader-enabled Plug-ins

      21
    • Development Environments

      22
      • Windows

        22
      • Mac OS X

        22
    • The Acrobat Core API

      22
      • Figure 2.1 Overview of Core API

        23
      • Acrobat Viewer Layer

        23
      • Portable Document Layer

        23
      • Acrobat Support

        24
      • Cos Layer

        24
      • Platform-Specific Methods

        24
    • Extended APIs For Plug-ins

      24
      • Plug-in APIs

        24
      • Adobe Dialog Manager

        25
  • Interapplication Communication (IAC)

    25
    • Development Environments

      25
    • Interapplication Communication Objects

      26
    • Using the Acrobat Distiller API

      26
    • IAC and Windows

      26
      • OLE Support on Windows

        26
      • PDF Browser Controls

        26
      • Accessing the JSObject Interface

        27
      • DDE Support

        27
    • Apple Event Support

      27
    • Using Plug-ins for Interapplication Communication

      27
    • Technical Limitations of Using the IAC API With Adobe Reader

      28
  • The Adobe PDF Library

    28
    • The Adobe PDF Library and the Adobe Acrobat SDK

      28
• Deciding Which Acrobat SDK Technology to Use

  29
  • Getting Started

    29
  • When to Use Interapplication Communication

    30
    • Viewing PDF Documents from an External Application

      30
      • Table 3.1 Comparing the PDF Browser Controls and IAC APIs

        30
    • Controlling Acrobat From an External Application

      30
      • Using IAC

        31
      • Executing Acrobat JavaScript

        31
    • Deciding Between Plug-ins and JavaScript

      31
      • General Issues

        32
        • Table 3.2 Plug-ins vs. JavaScript - General Issues

          32
      • What You Can Do with Plug-ins That You Can’t Do with JavaScript

        33
      • What You Can Do with JavaScript That You Can’t Do with a Plug-in

        33
  • Samples Provided with the Acrobat SDK

    34
    • Plug-in Samples

      34
      • Complete Plug-in Samples

        34
      • Plug-in Snippets Using SnippetRunner

        34
    • Acrobat JavaScript Samples

      35
    • Interapplication Communication Samples

      35
• Creating PDF Documents

  37
  • Creating PDF Documents with Acrobat

    37
    • Acrobat PDFMaker

      37
    • Adobe PDF Printer

      38
    • Save As or Export

      38
  • Creating PDF Documents from an Authoring Application

    39
    • Acrobat Distiller

      39
    • Apple Event Support

      40
    • Distiller Automation on Windows Using OLE Automation

      40
    • Automated, Silent Creation of PDF Documents from Windows

      41
    • Choosing an Adobe PDF Settings File

      41
    • Automatically Generating Advanced Acrobat Features

      41
    • Inserting PostScript Code into a Job

      42
    • Attaching the Native Document to the PDF File

      42
      • Using Links to Associate a Native Document with the PDF File

        42
    • Batch Processing with Distiller

      42
    • Creating Tagged PDF Documents

      43
      • PDF Logical Structure

        43
      • The Structure Tree

        43
      • Adding Structure Data to a PDF Document

        44
      • Using pdfmark to Add Structure Data to PDF

        44
  • Creating PDF Documents Using Plug-ins or Acrobat JavaScript

    45
    • Creating an Empty PDF File

      45
      • Using Acrobat JavaScript

        45
      • Using a Plug-in

        45
    • Creating PDF Files from Multiple Files

      45
      • Using Acrobat JavaScript

        45
      • Using a Plug-in or IAC

        45
    • Creating PDF Files Without Using Acrobat

      46
      • Generating PDF Files Without Using Adobe Applications

        46
• Working with PDF Documents

  47
  • Automating Processes: Opening PDF Documents Silently

    48
  • Adding Navigation to PDF Documents

    49
    • Adding and Managing Bookmarks

      49
    • Adding and Managing Thumbnails

      50
    • Adding and Managing Links

      50
    • Using Actions for Special Effects

      51
  • Manipulating Pages of a PDF File

    51
    • Creating and Editing Page Content

      52
      • PDFEdit API

        52
      • PDFEdit Samples

        52
    • Using Document Logical Structure

      53
      • Navigating a PDF Document

        53
      • Extracting Data From a PDF Document

        53
      • Adding Structure Data to a PDF Document

        53
      • Using pdfmark to Add Structure Data to PDF

        53
    • Modifying PDF Documents in Other Ways

      54
  • Adding Watermarks

    54
    • Fixed Printing for Engineering Documents

      54
    • Spell-Checking

      55
    • Using Multimedia

      55
    • Interacting with OBDC Databases

      56
  • Printing PDF Files

    56
    • Customizing and Automating Printing

      56
      • Printing from Acrobat JavaScript

        56
      • Printing from a Plug-in

        56
      • Printing from an External Application

        57
    • Working with Embedded Fonts

      57
    • Large Page Sizes in PDF Documents

      58
  • Wireframe Drawing

    58
• Modifying the User Interface

  59
  • Adding or Removing Menus and Menu Items

    59
    • Adding Menu Items

      59
    • Adding a New Menu

      60
  • Modifying the Toolbar

    60
    • Adding Items to an Existing Toolbar

      60
    • Creating a New Toolbar

      60
  • Using the Adobe Dialog Manager (ADM)

    61
    • ADM Controls

      61
    • ADM Objects

      62
      • Figure 6.1 ADM Objects

        62
    • Using ADM from Acrobat JavaScript

      63
    • Using the ADM API from a Plug-in

      63
      • Macintosh Issues

        63
    • Customizing Acrobat Help

      64
      • Controlling the “About” Box and Splash Screen

        64
      • Placing Plug-in Help Files in a Standard Location

        64
      • Customizing the How-To Panel

        65
• Using Online Collaboration and Annotations

  67
  • Using Online Collaboration

    67
    • How FDF Files Are Used

      68
    • Online Collaboration and Acrobat JavaScript

      68
    • Extensibility

      68
  • Using Annotations in Document Workflows

    69
    • Annotations and JavaScript

      69
    • Annotations and Plug-ins

      70
    • Annotations and the IAC API

      70
    • Creating New Annotation Types

      70
  • Using Stamps in Approval Workflows

    71
• XML and the Acrobat SDK

  73
  • The Adobe XML Architecture

    73
    • XML Forms

      74
    • XML Templates

      74
    • Extensible Metadata Platform (XMP)

      74
    • SOAP and Web Services

      74
      • DNS Service Discovery

        75
      • Workflow Applications

        75
  • Converting PDF Documents to XML Format

    76
    • Converting to XML Format Using Acrobat JavaScript

      76
    • The SaveAsXML Plug-in

      76
      • Overview of the SaveAsXML Process

        76
    • Managing XML-based Information

      77
• Forms and the Acrobat SDK

  79
  • Types of Forms

    79
    • XML Forms

      79
    • Acrobat Forms

      80
  • Forms Workflows

    81
    • Fill and Print

      81
    • Email Submit

      81
    • Online Submit

      81
    • Elements of Acrobat Forms

      81
  • Guidelines for Creating a New Form

    82
    • Acrobat Forms and the Acrobat SDK

      82
      • Acrobat JavaScript for Acrobat Forms

        82
      • The Forms API

        83
      • OLE Automation for Acrobat Forms

        83
  • XML Forms and the Acrobat SDK

    84
    • Automatically Populating Forms

      84
    • Creating Web-Ready Forms

      84
    • Punchcard/Barcode Form Fields

      84
    • Collecting Data from Completed Forms

      85
      • XML and XDP Formats

        85
      • FDF and XFDF Formats

        85
      • Saving Data to a Microsoft Excel Spreadsheet

        85
      • Submitting Data from Attachments

        85
      • Exporting Data as Images

        85
    • XML Form Templates

      86
• Rights-enabled PDF Documents

  87
  • Additional Usage Rights

    87
  • Differences between Usage Rights and Reader Enabling

    88
  • Creating Rights-enabled Documents

    89
    • Accessing Additional Usage Rights

      89
  • Applying and Validating Additional Usage Rights

    90
    • Effects of Reader Extensions on Acrobat Standard and Acrobat Professional

      90
    • Enabling Collaboration

      90
• Providing Document Security

  91
  • Acrobat Security Overview

    91
  • Encryption and Decryption

    92
  • Digital IDs and Certificates

    92
    • Obtaining a Digital ID from a Third Party

      93
    • Digital IDs and the Acrobat SDK

      93
  • Security Handlers

    94
    • PPKLite and PPKMS Security Handlers

      94
    • Security Handlers and Plug-ins

      94
    • Security Handlers and Acrobat JavaScript

      95
    • Digitally Signing Adobe PDF Documents

      96
      • Signing Adobe PDF Documents

        96
      • Certifying PDF Documents

        97
      • Validating Signatures

        97
    • Security Policies

      97
      • Using Adobe Policy Server

        98
      • Encrypting PDF Documents Using Security Policies

        98
    • Using eEnvelopes to Send Secure Files

      98
  • Document Rights

    99
• Working with Metadata

  101
  • Types of Metadata

    101
    • Document Information Dictionary

      102
    • Metadata Streams

      102
  • Extensible Metadata Platform (XMP)

    102
    • Accessing XMP Metadata Using Acrobat JavaScript

      103
    • Accessing XMP Metadata From a Plug-in

      103
    • Acrobat Distiller and XMP Metadata

      103
  • The Adobe XMP Toolkit

    103
  • Searching Metadata

    104
  • Object Data

    104
    • Creating Object Data

      105
    • Searching and Accessing Object Data

      105
• Searching and Indexing

  107
  • The Acrobat Search Plug-in

    107
    • Creating Custom Searches

      107
    • Search Options

      108
      • Matching Criteria

        108
    • Searching across Multiple Documents

      108
    • Replacing the Acrobat Search Plug-in

      108
  • Indexing PDF Documents

    109
    • Extracting and Highlighting Text

      109
    • Indexing and Acrobat JavaScript

      109
    • The Acrobat Catalog Plug-in

      109
• Accessibility

  111
  • Accessibility Overview

    111
  • Optimizing the Accessibility of PDF Documents

    112
  • Making Forms Accessible

    112
    • Field Descriptions

      112
    • Setting Tab Order

      113
  • Annotations and Accessibility

    113
    • Tagged Annotations

      113
  • Text-To-Speech

    113
  • Accessibility and Security

    113
  • Microsoft’s Active Accessibility (MSAA) Interface

    114
• Working With PDF Layers

  115
  • About Adobe PDF layers

    115
  • Creating Layered PDF Files

    116
  • Navigating with Layers

    116
  • Working with Layers from Acrobat JavaScript

    116
  • Working with Layers from a Plug-in

    117
• Index

  119