Adobe ACROBAT SDK 8.1 Manuals

Manuals and User Guides for Adobe ACROBAT SDK 8.1. We have 1 Adobe ACROBAT SDK 8.1 manual available for free PDF download: Manual

ADOBE ACROBAT SDK 8.1 Manual (253 pages)

Developing Plug-ins and Applications

Brand: ADOBE | Category: Software | Size: 4.79 MB

Table of Contents
3
List of Examples

11
Preface

14
- What's in this Guide
  14
- Who Should Read this Guide
  14
- Related Documentation
  14
Introduction

16
- About Plug-Ins
  16
- About the Acrobat Core API
  17
Understanding Plug-Ins

27
- About Plug-In Initialization
  27
  - Plug-In Loading and Initialization
    28
  - Handshaking and Initialization
    28
  - Exporting Hfts
    29
  - Importing Hfts and Registering for Notifications
    29
  - Initialization
    29
  - Unloading
    29
  - Summarizing a Plug-In's Life Cycle
    30
  - Using Callback Functions
    30
  - Notifications
    31
  - Handling Events
    31
    
    Adjust Cursor
    31
    
    Key Presses
    31
    
    Mouse Clicks
    31
Understanding Plug-Ins (Continued)

31
- Using Plug-In Prefixes
  31
  - Obtaining a Developer Prefix
    31
  - Using a Developer Prefix
    32
    
    Menu Items Prefixes
    32
    
    Menu Prefixes
    32
    
    Plug-In Name
    32
    
    Tool Prefixes
    32
    
    Toolbar Button Prefixes
    32
    
    Action Prefixes
    33
    
    Annotation Prefixes
    33
    
    HFT Prefixes
    33
    
    Private Data Prefixes
    33
  - Modifying the Acrobat or Adobe Reader User Interface
    33
    
    Adding or Removing Menus and Menu Items
    34
    
    Controlling the about Box and Splash Screen
    34
    
    Creating Help Files
    34
    
    Modifying Toolbars
    34
    
    User Interface Guidelines
    34
  - Acquiring and Releasing Objects
    35
  - Debugging Plug-Ins
    35
  - Page View Layers
    36
  - Minimizing Screen Redrawing
    36
  - Storing Private Data in PDF Files
    37
  - Exporting Data from PDF Document Objects
    37
Creating Plug-In and PDF Library Applications

39
- Supported Environments
  39
- Working with Platform-Specific Techniques
  40
  - About Platform-Dependent Data
    40
  - Portability Techniques
    40
  - Windows Techniques
    41
    
    Developing a Windows Plug-In
    41
    
    Locating and Loading Plug-Ins
    41
    
    Why a Plug-In Might Not Load
    41
    
    Debugging
    42
    
    Interapplication Communication
    42
    
    Macros and Project Settings
    42
    
    Handling the Thread Local Storage (TLS) Limit
    43
    
    Using Modal Dialog Boxes
    43
    
    Developing a Mac os Plug-In
    44
    
    Mac os Techniques
    44
    
    Locating and Loading Plug-Ins
    46
    
    Resource File Considerations
    46
    
    Using Memory
    46
    
    Interapplication Communication
    47
    
    Mac OS-Only Methods
    47
Creating Plug-In and PDF Library Applications (Continued)

47
- Creating a Sample Plug-In
  47
  - Including Acrobat SDK Library Files
    48
  - Adding the Pimain Source File
    53
  - Adding Application Logic
    53
  - Compiling and Building Your Plug-In
    53
  - Creating a Sample PDF Library Application
    54
    
    Contents of the PDF Library SDK
    54
    
    Including Library Files
    54
    
    Sample Code
    55
    
    Developing Applications with the Adobe PDF Library
    56
    
    Mac os
    57
    
    Unix
    57
    
    Windows
    57
    
    Initialization and Termination
    58
    
    Multithreading
    59
  - Upgrading Existing Plug-Ins
    59
    
    Detecting Supported Apis
    59
    
    Updates to Ascoord and Avrect
    60
    
    Upgrading Plug-Ins in Windows
    60
    
    Upgrading Plug-Ins on Mac os
    61
  - Migrating a PDF Library Application from Codewarrior to Xcode
    61
Inserting Text into PDF Documents

62
- About Inserting Text into a PDF Document
  62
  - Creating a New PDF Document
    63
  - Creating a New Page
    63
  - Creating a Container
    63
- Example 4.1
  63
  - Acquiring Fonts
    64
- Acquiring a Font that Is Used to Draw Text on a Page
  64
- Example 4.3
  64
  - Creating a Pdecontent Object
    64
- Example 4.5
  65
- Example 4.7
  66
- Inserting Text into a PDF Document
  66
- Example 4.8
  67
  - Examining a PDF Library Application Source File
    68
- Example 4.9
  68
Working with Documents and Files

72
Creating Menus and Menu Commands

88
- About Menus
  88
- Example 6.1
  91
  - Adding a Menu Command to a New Menu
    92
- Example 6.2
  92
  - Creating Menu Callback Functions
    93
  - Creating Menu Callback Functions
    94
- Example 6.3
  94
  - Determining if a Menu Item Can be Executed
    96
Creating Toolbars and Buttons

97
- About Toolbars
  97
  - About Avtoolbar Typedefs
    98
  - About Avtoolbutton Typedefs
    98
  - Retrieving Toolbars
    98
- Retrieving a Toolbar by Name
  99
- Example 7.1
  99
  - Creating Toolbar Buttons
    100
  - Creating a Toolbar Button
    100
- Example 7.2
  100
  - Setting Help Text for a Button
    101
  - Setting Label Text
    101
  - Setting a Button's Help Text
    101
- Example 7.3
  101
- Example 7.4
  102
  - Retrieving Existing Toolbar Buttons
    103
    
    Attaching a Button to a Toolbar
    103
- Example 7.5
  103
  - Exposing a Button in a Web Browser
    104
  - Attaching a Button to a Toolbar
    104
- Example 7.6
  104
  - Removing a Button from a Toolbar
    105
  - Creating Toolbar Button Callback Functions
    105
- Example 7.7 Exposing a Button in a Web Browser
  104
- Example 7.8
  105
  - Creating a Toolbar Button Callback Function
    106
- Example 7.9
  106
Creating Annotations

108
- About Annotations
  108
- Creating Text Annotations
  108
- Creating Text Annotations
  109
- Example 8.1
  109
  - Retrieving Existing Annotations
    110
  - Modifying Text Annotations
    111
- Example 8.3
  112
- Example 8.3 Modifying a Text Annotation
  112
Working with Bookmarks

113
- About Bookmarks
  113
- Creating Bookmarks
  114
- Example 9.1
  114
  - Defining Bookmark Actions
    115
    
    Creating a Pdviewdestination Object
    115
    
    Assigning an Action to a Bookmark
    116
    
    Creating a Avpageview Object
    116
- Example 9.2
  116
  - Removing Bookmark Actions
    117
  - Opening and Closing Bookmarks
    117
  - Opening a Bookmark
    117
- Example 9.3
  117
  - Retrieving Bookmarks
    118
    
    Retrieving a Specific Bookmark
    118
    
    Retrieving the Root Bookmark
    118
- Example 9.4
  118
  - Retrieving All Bookmarks
    119
- Retrieving Existing Bookmarks
  119
  - Deleting Bookmarks
    120
- Example 9.7 Deleting a Bookmark
  121
Working with Page Views and Contents

122
- About Page Coordinates
  122
- About Page Views
  124
- Displaying Page Views
  124
- Modifying Page Contents
  125
  - Creating a Pdecontent Object
    125
- Example 10.1 Displaying a Page View
  125
  - Accessing Page Contents
    126
- Example 10.2 Creating a Pdecontent Object
  126
  - Determining Page Element Types
    127
- Example 10.3 Accessing Page Contents
  127
- Example 10.4 Determining Page Element Types
  127
  - Modifying Text Elements
    128
- Example 10.5 Modifying Page Contents
  129
Working with Words

131
Creating Handlers

138
- About Handlers
  138
- Action Handlers
  139
- Annotation Handlers
  140
- Avcommand Handlers
  140
  - Creating an Avcommand Handler
    140
  - Invoking Avcommands
    141
  - Configuring Avcommands
    141
    
    Setting Input Parameters
    141
- Example 12.1 Creating an Avcommand Handler
  141
  - Setting Configuration Parameters
    142
  - Setting Avcommand Parameters
    142
- Example 12.2 Setting Input Parameters
  142
- Example 12.3 Setting Configuration Parameters
  142
- Example 12.4 Setting Avcommand Parameters
  142
  - Running Commands
    143
- Example 12.5 Running an Avcommand
  143
  - Exposing Avcommands to the Batch Framework
    144
    
    Adding a Handler to the Global Command List
    144
    
    Supporting Properties
    144
    
    File Format Conversion Handlers
    145
- Example 12.6 Exposing Avcommands to the Batch Framework
  145
  - File Specification Handlers
    146
  - Selection Servers
    146
  - Tool Callbacks
    147
  - Window Handlers
    147
  - File Systems
    148
  - Progress Monitors
    149
  - Transition Handlers
    149
  - Adding Message Handling
    150
Registering for Event Notifications

151
Working with Document Security

154
- About Document Security
  154
- About Security Handlers
  154
  - Adding a Security Handler
    155
  - Opening a Secured File
    157
  - Saving a Secured File
    158
  - Setting Security for a Document
    159
    
    Opening an Encrypted File
    159
    
    Saving a File with an Encryption Dictionary
    159
Working with Unicode Paths

160
Working with Host Function Tables

164
Working with Cos Objects

178
- About Cos Objects
  178
  - About Direct and Indirect Objects
    179
  - About Cos Object Types
    179
    
    Cos Strings
    179
    
    Cos Arrays
    181
    
    Cos Names
    181
    
    Cos Dictionaries
    182
    
    Cos Streams
    183
  - Working with Cos Strings
    183
    
    Creating Cos Strings
    183
- Example 17.1 Creating a Cos String
  183
  - Retrieving the String Value
    184
  - Working with Cos Arrays
    184
    
    Creating Cos Arrays
    184
- Example 17.2 Retrieving the String Value from a Cosdoc Object
  184
  - Retrieving Cos Array Values
    185
- Example 17.3 Creating a Cos Array
  185
  - Working with Cos Dictionaries
    186
    
    Creating Cos Dictionaries
    186
- Example 17.4 Retrieving Cos Array Values
  186
  - Retrieving Values from a Cos Dictionary
    187
- Example 17.5 Creating a Cos Dictionary
  187
  - Querying a Cos Dictionary for a Key
    188
- Example 17.6 Retrieving a Value from a Cos Dictionary
  188
- Example 17.7 Querying a Cos Dictionary for a Key
  188
  - Creating Cos Names
    189
  - Retrieving the Value of a Name Object
    189
Working with Cos Objects (Continued)

188
Creating 3D Annotations

203
- Creating Annotations
  203
- Adding 3D Data to an Annotation
  204
  - Creating the 3D Annotation Dictionary Entries
    205
  - Specifying the 3D Stream
    205
    
    Creating the Stream Object
    206
    
    Adding the Cos Stream to the Annotation Dictionary
    207
    
    Creating the Attributes Dictionary
    207
    
    Specifying Javascript Code
    208
    
    Setting the Default View
    209
    
    Setting the Annotation Appearance
    210
    
    Setting the Activation Dictionary
    213
- Example 19.1 Creating an Exception Handler
  214
  - Returning a Value from an Exception Handler
    215
  - Raising Exceptions
    215
  - Exception Handling Scenarios
    215
    
    Using Goto Statements
    215
    
    Using Nested Exception Handlers
    216
    
    Using Register Variables
    217
Handling Exceptions

214
- Creating Exception Handlers
  214
Working with Acrobat Extended Apis

218
Working with Acrobat Extended Apis (Continued)

229
- Digital Signature Extended API
  229
  - The Pubsec Layer
    230
  - Digital Signature Components
    231
  - Digital Signature Scenarios
    231
  - Initializing the Digital Signature Plug-In
    232
  - Understanding the Process
    232
  - Forms Extended API
    235
  - Weblink Extended API
    236
    
    Weblink Services
    236
    
    Writing a Custom Driver
    236
  - Spelling Extended API
    237
  - Acrocolor Extended API
    238
- Example 20.6 Converting a Page in a PDF Document to Apple RGB
  243
  - PDF Optimizer API
    244
Creating an Adobe Reader Plug-In

245
- Enabling an Adobe Reader Plug-In
  245
- Creating Resource Files on the Mac os Platform
  246
Index

250

Adobe Categories

Software

Plumbing Product

More Adobe Manuals

Adobe ACROBAT SDK 8.1 Manuals

ADOBE ACROBAT SDK 8.1 Manual (253 pages)

Table of Contents

List of Examples

Preface

Introduction

Understanding Plug-Ins

Understanding Plug-Ins (Continued)

Creating Plug-In and PDF Library Applications

Creating Plug-In and PDF Library Applications (Continued)

Inserting Text into PDF Documents

Working with Documents and Files

Creating Menus and Menu Commands

Creating Toolbars and Buttons

Creating Annotations

Working with Bookmarks

Working with Page Views and Contents

Working with Words

Creating Handlers

Registering for Event Notifications

Working with Document Security

Working with Unicode Paths

Working with Host Function Tables

Working with Cos Objects

Working with Cos Objects (Continued)

Creating 3D Annotations

Handling Exceptions

Working with Acrobat Extended Apis

Working with Acrobat Extended Apis (Continued)

Creating an Adobe Reader Plug-In

Index

Related Products

Adobe Categories