Accessibility

Adobe Systems is committed to developing and providing the vision and motion challenged community with the tools and resources to make digital information more accessible.
Using accessibility features in Acrobat Reader 5.0
Accessibility features are only available if you downloaded the Adobe Acrobat Reader with Search and Accessibility option. At present, accessibility features are more robust on the Windows platform.This chapter covers using the accessibility features of Acrobat Reader 5.0. For a PDF le to be accessible, it must have been created with accessibility in mind. For example, the PDF le must have structure. Screen readers will have trouble presenting the document if the structure tree is incomplete. Important: If you have a PDF le which cannot be read by assistive technologies, contact the author of the document, and request that it be made accessible using Adobe Acrobat 5.0.
Using a screen reader with Acrobat Reader 5.0
Mac OS does not offer a general accessibility interface for screen readers. Acrobat Reader 5.0 does not support screen readers on the Mac OS. On the Windows platform Adobe Acrobat Reader 5.0 supports the use of several screen reader applications. Please refer to your screen reader documentation for information on installation and use with Adobe Acrobat Reader 5.0.The screen reader will follow the logical structure of the document. You can control whether the content is delivered to the screen reader in single pages, or the entire document at once. For more information on accessibility preferences, see Setting Accessibility preferences on page 7.
Using Acrobat Reader 5.0 and Microsoft Internet Explorer (Windows only)
You can use the keyboard to control Adobe Acrobat Reader 5.0 within Microsoft Internet Explorer. If you open an Adobe PDF document from within Internet Explorer, the navigation and command keystrokes will function normally.The Tab key moves the focus from the browser to the Acrobat Reader document pane. Pressing Tab again will select the items in the document. Press Shift + Tab to move in reverse. To return the focus to the browser, press Ctrl + Tab. When in the browser, use the Internet Explorer keystrokes for navigation and selection.
Using keyboard shortcuts for menu commands and navigation
Navigation functions can be controlled through the keyboard as well as the mouse.You can change focus areas, and manipulate menus and dialog boxes. Focus areas are large sections of the interface that are treated as logical entities. Within these you may have more detailed navigation. Focus areas have an outline around them. Some of the gestures used to navigate may differ from those used in other Windows applications.This is due to both the different types of elements that are available in Adobe Acrobat Reader, and also to ensure compatibility with earlier versions. To toggle the focus area between the document and navigation panes: Press F6 to toggle the focus between the document and navigation panes.

Setting Accessibility preferences
The accessibility preferences are designed to aid vision and motion challenged users.You can set high contrast color schemes, custom text and background colors, and screen reader options. In general Adobe recommends that you use the system color schemes available through your operating system. To set Accessibility preferences: 1 Choose Edit > Preferences > Accessibility. 2 In the Alternate Document Colors section, select from the Adjust Display of Colors options: When document doesnt specify colors Is the default. Acrobat Reader will adjust colors to your custom scheme when the document does not specify any. Always, overriding document colors Will always change the colors of the document to your custom scheme. 3 Select from the Color Scheme options: Use colors specied in document Will display the document as presented by the author. Use custom color scheme Will present the document with your selections. Use Windows colors Will present the document using your system colors. 4 In the Custom Scheme section, specify a Custom Scheme (available only if Use custom scheme is selected):
Click the Text Color button to open the color swatch and choose a color. Click the Page Background Color button to open the color swatch and choose a color.
Once you have created a custom color scheme, you can choose Custom Colors from the Color Scheme pop-up menu to use your scheme when displaying a document. Some onscreen items wont be affected by a custom color scheme. For example, the color of lines and images wont change. 5 Choose a Content Delivery option (Windows only):
Select Deliver data in pages when document exceeds and enter a value.
Acrobat Reader can deliver a PDF document one-page-at-a-time to a screen reader if it exceeds the number of pages you specify. If you check this option and set this number to 0, then Acrobat Reader will deliver every PDF document one-page-at-a-time.
Deselect the Deliver data in pages when document exceeds option, and Adobe Acrobat Reader always delivers the entire PDF document to the screen reader.

Click OK.

Opening PDF documents
The creator of a PDF document can set the document to open in a variety of ways. For example, a document might open to a particular page number, at a particular magnication, or with the bookmarks or thumbnails visible.
If a document is set to open in Full Screen view, the toolbar, command bar, menu bar, and window controls are not visible.You can exit Full Screen view by pressing Escape, if your preferences are set this way, or by pressing Ctrl+L (Windows) or Command+L (Mac OS). For more on this view, see Reading documents in Full Screen view on page 10. To open a PDF document: Do one of the following:
, or choose File > Open. In the Open dialog box, select one or Click the Open button more lenames, and click Open. PDF documents usually have the extension.pdf. Choose the documents lename from the File menu.The menu lists the four PDF documents you last opened. Double-click the le icon in your le system.

Note: On Mac OS, you may not be able to open a PDF document created in Windows by double-clicking the icon. If double-clicking the icon on Mac OS does not open the document, use the File > Open command in Acrobat Reader to open the document. After youve used the Open command once on the document, youll be able to open the document next time by double-clicking.
Adjusting the view of PDF documents
You can change the magnication level of a PDF document and set a page layout that determines whether youll see one page at a time or a continuous ow of pages.
Magnifying and reducing the view
The minimum and maximum zoom levels available depend on the current page size. If you need to magnify a page to a size larger than the window, use the hand tool to move the page around so that you can view all the areas on it. Moving a PDF page with the hand tool is like moving a piece of paper on a desk with your hand. To increase magnication: Do one of the following:

Select the zoom-in tool

, and click the page.
Select the zoom-in tool, and drag to draw a rectangle, called a marquee, around the area to magnify. Click the triangle next to the magnication value box in the viewing toolbar, and choose a magnication level. Click the Zoom In button in the viewing toolbar.
To decrease magnication: Do one of the following:

Select the zoom-out tool

Select the zoom-out tool, and drag to draw a marquee the size you want the reduced page to be. Click the triangle next to the magnication value box in the viewing toolbar, and choose a magnication level.
Click the Zoom Out button

in the viewing toolbar.

Note: When the zoom-in tool is selected, you can press Ctrl (Windows) or Option (Mac OS) while clicking or dragging to zoom out instead of in. When the zoom-out tool is selected, press Ctrl or Option to zoom in. To change the magnication level using a thumbnail: 1 Choose Window > Thumbnails to open the Thumbnails palette. 2 Position the pointer over the lower right corner of the red page-view box in the thumbnail until the pointer changes to the double arrow. 3 Drag the corner of the box to reduce or expand the view of the page. To resize a page to t the window: Do one of the following:

To resize the page to t entirely in the window, click the Fit In Window button choose View > Fit in Window. To resize the page to t the width of the window, click the Fit Width button choose View > Fit Width. Part of the page may be out of view.

, or , or

To resize the page so that its text and graphics t the width of the window, choose View > Fit Visible. Part of the page may be out of view.
To return a page to its actual size: Click the Actual Size button , or choose View > Actual Size.The actual size for a PDF page is typically 100%, but the document may have been set to another magnication level when it was created.
Setting the page layout and orientation
You can use three page layouts when viewing PDF documents:
Single Page layout displays one page in the document pane at a time. Continuous layout arranges the pages in a continuous vertical column. Continuous - Facing layout arranges the pages side by side.This conguration accommodates a two-page spread display and multiple-page viewing in the window. If a document has more than two pages, the rst page is displayed on the right to ensure proper display of two-page spreads.
Single Page layout, Continuous layout, and Continuous - Facing layout compared
In Single Page layout, the Edit > Select All command selects all text on the current page. In Continuous and Continuous - Facing layouts, it selects most of the text in the PDF document. To set page layout: Do one of the following: Using Help | Contents | Index Back 9
Click the Single Page button button in the status bar.

, the Continuous button

, or the Continuous - Facing
Choose Single Page, Continuous, or Continuous - Facing from the View menu.
To see two-page spreads most efciently, use the Continuous - Facing page layout, and choose View > Fit Width. To rotate a page: Do one of the following:
Click the Rotate View Clockwise button button in the status bar.
or the Rotate View Counter-Clockwise
Choose Rotate View Clockwise or Rotate View Counter-Clockwise from the View menu.
You can change the orientation of a page in 90-degree increments with the rotation tools.
Reading documents in Full Screen view
In Full Screen view, PDF pages ll the entire screen; the menu bar, command bar, toolbar, status bar, and window controls are hidden. A document creator can set a PDF document to open in Full Screen view, or you can set the view for yourself. Full Screen view is often used for presentations, sometimes with automatic page advancement and transitions. The pointer remains active in Full Screen view so that you can click links and open notes. You can use keyboard shortcuts for navigational and magnication commands, even though the menus and toolbar are not visible.You can also set preferences to dene how Full Screen view appears on your system. To read a document in Full Screen view: Choose View > Full Screen. Press Return or the Down Arrow or Right Arrow key to page through the document. Press Shift-Return or the Up Arrow or Left Arrow key to page backward through the document. Note: If youre using Windows 98, Windows 2000, or Mac OS and have two monitors installed, the Full Screen view of a page appears on only one screen. To page through the document, click the screen displaying the page in Full Screen mode. To exit Full Screen view: Press Escape, if your Full Screen preferences are dened this way, or press Ctrl+L (Windows) or Command+L (Mac OS). To set preferences for Full Screen view: 1 Choose Edit > Preferences > Full Screen. 2 Select the navigation options:

Setting Acrobat Reader preferences
You can use preferences to dene a default page layout, enable Web Buy, and customize Acrobat Reader in many other ways. General preferences settings are described here. Note: These preferences control the Acrobat Reader application on your system; they are not associated with a particular document. To set Acrobat Reader preferences: Choose Edit > Preferences, or choose Preferences from the document pane menu. Select one of the features from the list at the left and select preference options for that feature. Accessibility Denes preferences for customizing color and page layout to make documents easier to read. For more information, see Setting Accessibility preferences on page 7. Comments Denes preferences for the appearance and functionality of document comments. For more information, see Setting comment preferences on page 28 Using Help | Contents | Index Back 17
Display Denes preferences for the appearance of pages within Acrobat Reader. Display options are:
Default Page Layout sets a page layout used for scrolling when you rst open a document.You can display pages one at a time as you scroll, continuously one above the next, or continuously side by side. Page Units species a unit of measure for displaying page size in the status bar, and Info palette. Application Language sets a language for the Acrobat Reader user interface.The popup menu shows the languages you installed with Acrobat Reader. If you choose a different language, the change takes effect the next time you start the application. Use Greek Text Below displays text below the designated point size as gray lines (or greeked text) to speed display time. Display Page To Edge eliminates the thin white border that is displayed around the edge of PDF pages created by some applications. If you do not select this option, pages are printed with a white border, as dened by the printer driver. Display Transparency Grid displays a grid behind transparent objects. You can choose to smooth text, line art, and image.Smoothing smooths the edges of text and monochrome images to minimize the contrast between the background and the text or image.This sometimes improves the quality of the display on-screen, especially with larger text sizes. Use CoolType lets you adjust the text display of Acrobat Reader to work optimally with your monitor. When you have choose this option, you must also calibrate CoolType by clicking Congure CoolType and choosing the text sample that looks the best. Default Zoom sets the magnication level for PDF documents when they are rst opened.This affects only documents that have Default set for their magnication level. Max Fit Visible sets the maximum magnication level for the Fit Visible view and for viewing articles.

Forms Denes preferences for the appearance and functionality of forms. Full Screen Denes preferences for the appearance and navigation of documents when Acrobat Reader is in the full screen mode. For information on the specic options, see Reading documents in Full Screen view on page 10. Identity Denes preferences for personal information which may be used for forms data. Options Denes preferences for opening Acrobat Reader, Web browsers, and other application preferences. Preference options are:
Display PDF in Browser displays any PDF les opened from the Web in your default browser. If this option is not selected, the PDF les will open in a separate Acrobat Reader window. Check Browser Settings checks your browser settings for compatibility with Acrobat Reader each time Acrobat Reader is launched. Allow Fast Web view displays PDF les from the Web one page at a time. If this option is not selected, the entire PDF will download before it is displayed. Allow Background Downloading allows a PDF document to continue downloading from the Web, even after the rst requested page displays on-screen in a Netscape
Navigator-compatible browser. If you do not select this option, only the requested page downloads to your computer, and other pages are downloaded as you request them.
Display Splash Screen At Startup shows the splash screen each time Acrobat Reader is launched. Certied Plug-ins Only Certied Plug-ins allows you open encrypted les you have purchased, but prevents third-party plug-ins from loading at startup.This option may be required if you are using the Web Buy feature. If you change this option, click OK to exit and restart Acrobat Reader. Use Page Cache places the next page in a buffer even before you view the page in Acrobat Reader.This reduces the amount of time it takes to page through a document. Use Logical Page Numbers allows you to set page numbering in a PDF document using the Document > Number Pages command.You typically do this when you want PDF page numbering to match the numbering printed on the pages. A pages number, followed by the page position in parentheses, appears in the status bar and in the Go To Page, Delete Pages, and Print dialog boxes. For example, if the rst page in a document is numbered i it might appear as i(1 of 10) If this option is not selected, Acrobat ,. Reader ignores page numbering information in documents and numbers pages using Arabic numbers starting at 1.
Note: You will get unexpected results from the Go Back command in your Web browser if you do not select this option. For example, if you link to another document from a partially downloaded PDF document and then want to return to that document by using Go Back, you return to the rst page of the PDF document, even if you were not on the rst page. This option should alleviate most cases of unexpected Go Back behavior in your Web browser.

Rening searches

If you want to narrow a search you can rene or conne your search to documents listed in a prior search. For example, you can rst search for (and nd) all documents by an author, and then dene a search query for that subset of documents.The result would be a subset of documents that are authored by the specied author and that contain the search string. To rene a search: 1 Choose Edit > Search > Results to display the Search Results window. Select and show the results of a previous search. 2 Choose Edit > Search > Query to open the Search dialog box. Edit or replace the query that produced the rst list of documents. If you used a simple text string for the search query, you might consider rening the search query by using the search options, by including document and date information in the search, or by using Word Assistant. For more information, see Using Word Assistant on page 24. 3 Press Ctrl (Windows) or Option (Mac OS).The button label changes from Search to Rene. 4 Click Rene.This produces a Search Results list of documents that are a subset of the previous list, and that match the new query.

Using Word Assistant

Word Assistant enables you to build a list of terms that will appear when you specify a search using the Sounds Like, Word Stemming, or Thesaurus options.The resulting list shows you if the option you are using is likely to return helpful results. If the list is too long or full of irrelevant words, you can quickly construct a list of words to nd by copying words from the Word Assistant dialog box and pasting them into the search dialog box. To use the Word Assistant with search options: 1 Choose Edit > Search > Word Assistant.
2 Click Indexes to check the available indexes or change the selection of indexes. 3 In the Index Selection dialog, select the indexes you want to use. Click OK. 4 Select a search option (Sounds Like, Word Stemming, or Thesaurus) from the Assist menu. 5 Enter the search word in the Word text box, and click Look Up. To copy words from the Word Assistant dialog box: 1 Choose Edit > Search > Query to open the Search dialog box. 2 Choose Edit > Search > Word Assistant, and use the Word Assistant to generate a list of related words. 3 Double-click a word to search.The selected word appears in the Word text box. 4 Copy the results in the Word text box, and paste them into the Find text box of the Search dialog box. 5 Repeat steps 3 through 5 for each word you want to use; separate each pair of words in the Find text box with AND or OR. 6 Click Search.

If the indexes do not specify stopwords, you can search for phrases in which they appear. If your search phrase includes the words and, or, or not used in their ordinary sense (not as a Boolean operator), put the phrase in quotes.The search phrase once or twice nds all occurrences of the phrase once or twice, not all occurrences of once and all occurrences of twice as it would without the quotes.
If your search phrase includes punctuation (other than an apostrophe) or special characters (such as @ and *), they are ignored. For example, either of the terms
son-in-law, son in law nds all occurrences of both son-in-law and son in law.
If you are unsuccessful in searching for a phrase that includes a common word, it is probably because it is a specied stopword. If you are unsuccessful in searching for a term that includes numbers, it is probably because numbers have been excluded from the index. Adobe Acrobat Catalog denes a number to be a sequence of one or more digits (0 through 9), optionally preceded by a minus sign (-), optionally separated by one or more commas (,) or periods (.), and optionally containing a decimal point, which can be a period (.) or a comma (,). If you use a separator character in a search term, it is automatically discarded. Separator characters include all symbols, the space character, and punctuation characters except the apostrophe. When indexing a PDF document, Acrobat Catalog uses separator characters to recognize where one term ends and the next term begins. If alphanumeric terms are made up of numbers and separator characters, they can also be excluded.

Using Boolean operators

To avoid building inaccurate search queries, follow these guidelines:
You can use operators in text and Document Info text boxes. You can use =, ~, and != with text only to perform exact matches, contains, and does not contain searches, respectively. You can use comparison operators (<, <=, >, >=) with values of the same type. When NOT is used with either or both of the AND and OR operators, it is evaluated before either the AND or OR. For example, evolution AND NOT Darwin nds all documents that contain the word evolution but not the word Darwin. When you combine AND and OR in the same expression, AND is evaluated before OR. For example, Darwin OR origin AND species nds all documents that contain Darwin or that contain both origin and species.

The Select All command will not select all the text in the document. 2 Choose Edit > Copy to copy the selected text to the Clipboard. 3 To view the text, choose Window > Show Clipboard. In Windows 95, the Clipboard Viewer is not installed by default, and you cannot use the Show Clipboard command until it is installed.To install the Clipboard Viewer, choose Start > Settings > Control Panel > Add/Remove Programs, and then click the Windows Setup tab. Double-click Accessories, check Clipboard Viewer, and click OK. To copy graphics to the Clipboard: 1 Select the graphics select tool. The cursor changes to the cross-hair icon. 2 Drag a rectangle around the graphic you want to copy.To deselect the graphic and start over, click anywhere outside the selected graphic. 3 Choose Edit > Copy to copy the graphic to the Clipboard. 4 To view the graphic, choose Window > Show Clipboard.The graphic is copied using the WMF (Windows), PICT (Mac OS), or XPIXMAP (UNIX) format. In UNIX, the graphic is pasted in the primary selection.

Using Web Buy

The Web Buy feature lets you buy and download eBooks, reference works, technical manuals, structured business documents, newspapers, and periodicals as PDF les that have been locked with the Adobe secure PDF technology to protect the copyrights of authors and publishers. Web Buy lets you unlock these les so that you can read and search them on your personal computer or reading device. A series of Web pages pops up in your browser to guide you through the process.
Setting your Web Buy preferences
Sellers of electronic documents may require that the use of an electronic document be tied to a particular computer or storage device.You can specify in the Web Buy preferences dialog box what storage device information you are willing to make available to sellers automatically when you purchase a secure PDF document over the Web. An advisory page will pop up in your Web browser if a seller seeks information other than that you have dened in your Web Buy preferences dialog box. To set your Web Buy preferences: 1 Select Edit > Preferences > Web Buy. 2 Make sure Enable Web Buy is checked. 3 Specify what warnings you would like to receive before information is sent to an on-line seller. 4 Select your preference of storage device from the Other Identier 1 drop-down menu. You may select an alternate storage device for Other Identier 2. All devices that are visible to your computer are listed in the drop-down menus. Note: If you lock a document to a portable device such as a Zip cartridge or Jaz drive, the document is portable. If you lock a document to your computer, the document can be read only on that machine. 5 Enter a path in the text box or click the Choose button to select a default folder in which to store your purchases. 6 Click OK.

Ctrl + W Ctrl + X Ctrl + Z Ctrl + 0 Ctrl + 1 Ctrl + 2 Ctrl + 3 Ctrl + + Ctrl + Ctrl + [ Ctrl + ] Ctrl + Spacebar Alt + Ctrl + Spacebar Ctrl + F1 Shift + Ctrl + A Shift + Ctrl + D Shift + Ctrl + I Shift + Ctrl + P Shift + Ctrl + S Shift + Ctrl + W Shift + Ctrl + Y Ctrl + U Shift + Ctrl + U Ctrl + Y Shift + Ctrl + + Shift + Ctrl + Ctrl + B

Searching

Find Find again Find rst suspect Query Search results Previous document (search) Next document (search)
Ctrl + F Ctrl + G Ctrl + H Shift + Ctrl + F Shift + Ctrl + G Shift + Ctrl + [ Shift + Ctrl + ]
Document Information and Preferences
Document Summary dialog box General Preferences dialog box

Ctrl + D Ctrl + K

Windows
Cascade Tile horizontally Tile vertically Close all
Shift + Ctrl + J Shift + Ctrl + K Shift + Ctrl + L Alt + Ctrl + W

Miscellaneous

Open Web Page Summarize Comments Select Indexes
Shift + Ctrl + O Shift + Ctrl + T Shift + Ctrl + X

Mac OS Shortcuts

Article Crop Form Hand Link Movie Pencil TouchUp object Notes tool TouchUp text Highlight text Text select tool Zoom in tool Zoom out tool Hidden Pencil tools: line, rectangle, ellipse Hidden Notes tools: text comment, audio comment, stamp, le comment Hidden Text Select tools: column select, graphics select, table select Hidden Highlight tools: strikethrough, underline Hidden TouchUp Text tools: touch up object Graphics Select
Page Up Page Down Spacebar Home End Del Left Arrow Right Arrow Up Arrow Down Arrow Cmd + L Cmd + N Left Arrow Cmd + Left Arrow Cmd + Right Arrow Right Arrow Shift + Cmd + Page Up Shift + Cmd + Page Down Option + Shift + Left Arrow Option + Shift + Right Arrow Shift + Cmd + Up Arrow Shift + Cmd + Down Arrow Cmd + Tab
Help Show/Hide bookmarks Next pane Spell check Show/Hide toolbars Find/Find Again Context menus In Navigation pane, goes to document view and leaves Navigation pane open Next secondary window Show/Hide thumbnails Show/Hide Menu Bar
F1 F5 F6 F7 F8 Cmd + F, Cmd + G Control + click Shift + F6 Option + F6 F4 F9
Select all Copy Zoom to Open Print Quit Rotate page(s) Save Crop page(s) Paste Close Cut Undo
Cmd + A Cmd + C Cmd + M Cmd + O Cmd + P Cmd + Q Cmd + R Cmd + S Cmd + T Cmd + V Cmd + W Cmd + X Cmd + Z
Fit in window Actual size Fit width Fit visible Zoom-in Zoom-out Previous (search) Next (search) Zoom in temporarily Zoom out temporarily Deselect all Delete page(s) Insert page(s) Page setup Save as Word Assistant Use local fonts Show/Hide Grid Snap to Grid Proof Colors Rotate Clockwise Rotate Counterclockwise Add New bookmark

Hide After Use command, for bookmarks 13 Highlight Next/Previous button 15
Identity preferences 18 information about documents 20

jumping to pages 12

Last Page button 12 license files 31 links, following 13
magnification decreasing 8 increasing 8 Match Case option 23, 28 Menu bar, keystroke access 5 Microsoft Internet Explorer accessibility 5 Tab key navigation 5 movies playing 28 system requirements 28
general document information 20 General preferences, setting 17 Go Back button 14 Go Forward button 14 Go To Next View button 14 Go To Page command 12 Go To Previous View button 14 graphics select tool 30
navigation pane, keystrokes 6 navigational structures articles 12 bookmarks 12 links 12 thumbnails 12 Next Page button 11, 12 nppdf32.dll file, installing 16
hand tool 8, 13 Help 1 helper application, Acrobat as 15
online Help 1 Open button 8
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Open command 8 opening PDF files 7 Options preferences Allow Background Downloading 18 Allow Fast Web 18 Allow File Open Actions 19 Certified Plug-ins Only 19 Check Browser Settings 18 Display PDF In Browser 18 Display Splash Screen At Startup 19 Open Cross-Document Links In Same Window 19 Reset All Warnings 19 Use Logical Page Numbers 19 Use Page Cache 19 orientation, changing 10 general, download Asian fonts 17 general, font substitution 17 general, printing as images 17 UNIX 34 Proximity option 23 Proximity option in searches 23
queries Boolean operators in 26 expanding 27 limiting searches 27 terms or phrases 26 Word Assistant 25 query command 22
Page Down/Up button 12 page layouts Continuous 9 Continuous-Facing 9 setting 9, 9 Single Page 9 page orientation 9 page-at-a-time downloading 15 PDF documents finding words in 20 getting information on 20 locked 31 PDFViewer plug-in, installing 16 PICT format 30 plug-ins, UNIX 33 preferences Accessibility 7 Full Screen 10 General 17 Previous Page button 11 Print button 16 printing general options 16 general page setup 16
reading articles 13 relevancy ranking 23 resizing magnifying and reducing 8 page views 9 pages 9 using thumbnails 9 resources, UNIX 33 Rotate View Clockwise button 10 Rotate View Counter-Clockwise button 10 rotating pages 10 rotation tools 10
screen reader, delivery options 7 Search command full-text search 22 using 22 search results document title or filename 20 PDF documents in Web site 15 viewing 23 Search Results window 24 searching indexes Boolean operators in 23, 26
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z customizing index selection 22 expanding a search 27 full-text search 22 limiting searches 27 queries 25 Query command 22 query defined 21 refining searches 24 relevancy ranking 23 Search command 22 selecting an index 22 terms or phrases 26 using Word Assistant 24 viewing results 23 wild-card characters 23 with Date Info 25 with Document Info 25 searching, in Web browsers 15 Select All command 9, 30 Select Indexes command 22 selecting and copying text 30 Show Clipboard command 30 Single Page layout 9 sound, system requirements 28 Sounds Like option 22, 25 system requirements for movie and sound files 28

Apple Information Access Toolkit software included.This software is based in part on the work of the Independent JPEG Group.THE PROXIMITY/MERRIAM WEBSTER DATABASE Copyright 1984, 1990 Merriam-Webster Inc. Copyright 1984, 1990, 1993 - All rights Reserved Proximity Technology Inc. THE PROXIMITY /FRANKLIN ELECTRONIC PUBLISHERS INC.- DATABASE Copyright 1994 Franklin Electronic Publishers Inc. Copyright 1994, 1997 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY / MERRIAM WEBSTER INC./ FRANKLIN ELECTRONIC PUBLISHERS INC. DATABASE Copyright 1990/1994 Merriam-Webster Inc./Franklin Electronic Publishers Inc. Copyright 1994, 1997 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY / WILLIAM COLLINS SONS & CO. LTD. DATABASE Copyright 1984, 1990 William Collins Sons & Co. Ltd. Copyright 1988, 1990, 1997 - All Rights Reserved Proximity Technology Inc.THE PROXIMITY /Dr. LLUIS DE YZAGUIRRE I MAURA DATABASE Copyright 1991 Dr, Llus de Yzaguirre i Maura Copyright 1991 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY / MUNKSGAARD INTERNATIONAL PUBLISHERS LTD. DATABASE Copyright 1990 Munksgaard International Publishers Ltd. Copyright 1990 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY / VAN DALE LEXICOGRAFIE BV DATABASE Copyright 1990, 1995, 1997 Van Dale Lexicograe bv Copyright 1990, 1996, 1997 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY /IDE A.S. DATABASE Copyright 1989, 1990 IDE a.s. Copyright 1989, 1990 - All rights Reserved Proximity Technology Inc THE PROXIMITY / HACHETTE DATABASE Copyright 1992 Hatchette Copyright 1992 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY /EDITIONS FERNAND NATHAN DATABASE Copyright 1984 Editions Fernand Nathan Copyright 1989 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY /TEXT & SATZ DATENTECHNIK DATABASE Copyright 1991 Text & Satz Datentechnik Copyright 1991 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY/ BERTLESMANN LEXICON VERLANG DATABASE Copyright 1997 Bertlesmann Lexicon Verlang Copyright 1997 - All Rights Reserved Proximity Technology Inc.THE PROXIMITY/WILLIAM COLLINGS SONS & CO. LTD./ BERTLESMANN LEXICON VERLANG DATABASE Copyright 1986/1997 William Collins Sons & Co. Ltd./ Bertlsmann Lexicon Verlang Copyright 1997 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY/ S. FISCHER VERLAG DATABASE Copyright 1983 S. Fischer Verlag Copyright 1997 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY/ZANICHELLI DATABASE Copyright 1989 Zanichelli Copyright 1989 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY/MORPHOLOGIC INC. DATABASE Copyright 1997 Morphologic Inc. Copyright 1997 - All Rights Reserved Proximity technology Inc. THE PROXIMITY/ RUSSICON COMPANY LTD. DATABASE Copyright 1993-1995 Russicon Company Ltd. Copyright 1995 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY/ESPASSA-CALPE DATABASE Copyright 1990 Espassa-Calpe Copyright 1990 - All Rights Reserved Proximity Technology Inc. THE PROXIMITY/C.A. STROMBERG AB DATABASE Copyright 1989 C.A. Stromberg AB Copyright 1989 - All Rights Reserved Proximity Technology Inc The TWAIN Toolkit is distributed as is. The developer and distributors of the TWAIN Toolkit expressly disclaim all implied, express or statutory warranties including, without limitation, the implied warranties of merchantability, noninfringement of third party rights and tness for a particular purpose. Neither the developers nor the distributors will be liable for damages, whether direct, indirect, special, incidental, or consequential, as a result of the reproduction, modication, distribution, or other use of the TWAIN Toolkit. Portions of Adobe Acrobat include technology used under license of Verity, Inc. and are copyrighted.

Contains an implementation of the LZW algorithm licensed under U.S. Patent 4,558,302. Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Notice to U.S. government end users.The software and documentation are commercial items, as that term is dened at 48 C.F.R. 2.101, consisting of commercial computer software and commercial computer software documentation, as such terms are used in 48 C.F.R. 12.212 or 48 C.F.R. 227.7202, as applicable. Consistent with 48 C.F.R. 12.212 or 48 C.F.R. 227.7202-1 through 227.7202-4, as applicable, the commercial computer software and commercial computer software documentation are being licensed to U.S. 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 set forth in the Adobe standard commercial agreement for this software. Unpublished rights reserved under the copyright laws of the United States.

Developing for Adobe Reader

Adobe Acrobat SDK

November 2006 Version 8.0
2006 Adobe Systems Incorporated. All rights reserved. Adobe Acrobat SDK 8.0 Developing for Adobe Reader for Microsoft Windows, Mac OS, Linux, and UNIX Edition 1.0, 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. 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. 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, Reader, LiveCycle, Photoshop, PostScript, Illustrator, and After Effects are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. AIX is a trademark of International Business Machines Corporation 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. HP-UX is a registered trademark of Hewlett-Packard Company. Intel is a registered trademark of Intel Corporation in the U.S. and other countries. JavaScript and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Linux is a registered trademark of Linus Torvalds. Microsoft and Windows are either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. Pentium is a trademark or registered trademark of Intel Corporation or its subsidiaries in the U.S. and other countries. Red Hat is a trademark or registered trademark of Red Hat, Inc. in the United States and other countries. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. Products bearing SPARC trademarks are based upon an architecture developed by Sun Microsystems, Inc. UNIX is a registered trademark of The Open Group in the United States and 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 U.S. Government End Users. The Software and Documentation are Commercial Items, as that term is defined at 48 C.F.R. 2.101, consisting of Commercial Computer Software and Commercial Computer Software Documentation, as such terms are used in 48 C.F.R. 12.212 or 48 C.F.R. 227.7202, as applicable. Consistent with 48 C.F.R. 12.212 or 48 C.F.R. 227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. 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. Unpublished-rights reserved under the copyright laws of the United States. Adobe Systems Incorporated, 345 Park Avenue, San Jose, CA 95110-2704, USA. For U.S. 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.

Contents

Preface..... 4
Whats in this guide?..... 4 Who should read this guide?...... 4 Related documentation...... 4

Introduction.... 6

Supported platforms..... 6 Windows...... 6 Mac OS....... 6 Linux...... 7 Solaris...... 7 AIX...... 8 HP-UX...... 8 Technologies available within the Acrobat SDK..... 8 JavaScript..... 9 Interapplication communication..... 9 Plug-ins...... 9

JavaScript APIs..... 10

Objects, properties and methods....10
Interapplication Communication... 25
OLE automation......25 DDE messages.....27 Apple events......27

Plug-ins..... 28

APIs available for Adobe Reader.....29

Index.... 30

Preface
Adobe Reader belongs to the Adobe Acrobat family of products, and is used for viewing, navigating, and printing PDF documents. For more information on the Acrobat family of products, see http://www.adobe.com/go/acrobat_developer.

Whats in this guide?

This guide provides an introduction to those portions of the Adobe Acrobat Software Development Kit (SDK) that pertain to your development efforts for Adobe Reader. It provides a general overview of the types of things you can do with the SDK and the technologies that are available to you through the SDK. This document provides a starting point for developers who would like to understand how to extend or customize Adobe Reader, and provides information clarifying how such efforts differ from those intended for Acrobat. It is possible to extend and customize Adobe Reader by using the Adobe Acrobat SDK to write JavaScript code, implement interapplication communication, and write plug-ins. This document indicates the relevant subsets of the JavaScript APIs, interapplication communication APIs, and the Acrobat and PDF Library APIs. It describes each of those collections of APIs and their intended purposes, and clarifies what is available on all supported platforms.
Who should read this guide?
This guide is meant for developers who are either new to Adobe Reader development or have experience with the Acrobat SDK. For information about Acrobat SDK technologies and the many ways that developers can extend Acrobat or Adobe Reader using the Acrobat SDK, see the Overview.

Related documentation

The following resources and samples provide further information about the Acrobat SDK, as well as additional documents that you should have available for reference. For information about A roadmap containing descriptions of all the documentation in the Acrobat SDK. A description of known issues and implementation details specific to the various platforms supported in the Acrobat SDK. Answers to frequently asked questions about the Acrobat 8.0 SDK. The new features in this SDK release. See Acrobat SDK Documentation Roadmap Readme

Developer FAQ Whats New

Related documentation 5
For information about A general overview of the capabilities and usage of the Acrobat SDK. An introduction to those portions of the Acrobat SDK that pertain to development efforts for Adobe Reader. Descriptions and implementation details for samples included with the Acrobat SDK. An overview of the SnippetRunner tool and the plug-in snippets provided with the Acrobat SDK. A description of how to develop external applications that use Apple events, AppleScript, DDE, or OLE to control Acrobat or Adobe Reader or render PDF documents. Detailed descriptions of the APIs available for Apple events, AppleScript, DDE, or OLE to control Acrobat or Adobe Reader or render PDF documents. An overview of how to use JavaScript to develop and enhance standard workflows in Acrobat or Adobe Reader. Detailed descriptions of the JavaScript APIs for developing and enhancing standard workflows in Acrobat or Reader. A detailed description of the PDF file format. A description of how to develop plug-ins for Acrobat and Adobe Reader, as well as PDF Library applications. A detailed description of the APIs available to create plug-ins for Acrobat and Adobe Reader, as well as PDF Library applications. Describes the syntax and semantics of the PostScript language and the Adobe imaging model.
See Overview Developing for Adobe Reader Guide to SDK Samples Snippet Runner Cookbook Developing Applications using Interapplication Communication Interapplication Communication API Reference Developing Acrobat Applications using JavaScript JavaScript for Acrobat API Reference PDF Reference Developing Plug-ins and Applications Acrobat and PDF Library API Reference
PostScript Language Reference, third edition

Introduction

This chapter describes the supported platforms for development using the Acrobat SDK, and summarizes the technologies available within the Acrobat SDK.

Supported platforms

This section describes the requirements for using the interapplication communication and Acrobat core and extended APIs on all supported platforms. The following platforms are currently supported for development with Adobe Reader:

Windows Mac OS Linux Solaris AIX HP-UX
Details for each platform are described below.

Windows

Versions Microsoft Windows 2000 with Service Pack 2
Microsoft Windows XP Professional or Home Edition
Development environments Microsoft Visual Studio.NET 2003
Microsoft Visual Studio 2005
Note: For more information on the Windows environment, see the Overview and Developing Plug-ins and Applications.

Mac OS

Versions Mac OS X versions 10.2.8 or later. Development environment Xcode 2.3
Note: For more information on Mac OS development environments, see the Overview and Developing Plug-ins and Applications.

Linux 7

Machine requirements 32-bit Intel Pentium-class processor, 128 MB RAM (256 MB recommended), 70 MB hard disk space. Distributions and versions Red Hat Enterprise Linux AS version 3.0, with Linux kernel version 2.4.21
Red Hat Enterprise Linux AS version 4.0, with Linux kernel version 2.6 Red Hat Enterprise Linux ES version 3.0, with Linux kernel version 2.4.21 Red Hat Enterprise Linux ES version 4.0, with Linux kernel version 2.6 Red Hat Linux Desktop Red Hat Linux version 9.0, with Linux kernel versions 2.4.20 through 2.6 SuSE Linux Enterprise Server version 9, with Linux kernel version 2.6 SuSE Linux Professional version 9.2, with Linux Kernel kernel 2.6.4 Turbolinux 10 Desktop, with Linux kernel version 2.6 Red Flag Linux Desktop 4.0
Note: Not all versions of Red Hat Linux will automatically install the GNOME GTK+ Library, which is required for developing plug-ins for Adobe Reader on Linux. To ensure that your Adobe Reader plug-ins will compile, make sure the GNOME GTK+ Library has been installed on your system.
Supported browsers Mozilla versions 1.73 and 1.8
Netscape version 7 Firefox version 1.0
Development environment Standard GNU Compiler: gcc version 3.2

Solaris

Machine requirements UltraSPARC or UltraSPARC IIIi processor, 128 MB RAM, 70 MB hard disk space. Versions Solaris Operating System versions 8 and 9 Supported browsers Mozilla version 1.73

Netscape version 7

Machine requirements RISC System/6000 or IBM Power5 processor, 128 MB RAM, 70 MB hard disk space. Versions IBM AIX versions 5.2 and 5.2.0.35 Supported browser Mozilla version 1.73 Development environment Native compiler: xIC version 6.0
Machine requirements 32 bit PA-8000x processor, 128 MB RAM, 70 MB hard disk space. Versions HP-UX versions 11 and 11i Supported browser Mozilla version 1.6 Development environment HP ANSI C++ native compiler: aCC version A.03.33

Technologies available within the Acrobat SDK
The primary technologies for creating software to extend or customize Adobe Reader are JavaScript, interapplication communication, and plug-ins. For information about choosing an appropriate technology for your project, see the Overview guide. It is important to consider the role of Adobe LiveCycle Reader Extensions in your development efforts with JavaScript and plug-ins. Though the APIs available for Adobe Reader are normally limited in both cases, additional APIs can be used for a given PDF document if that document is rights-enabled, meaning that it has additional usage rights. LiveCycle Reader Extensions is a server product that enables document producers and creators to quickly and easily embed additional usage rights into PDF documents, which results in extra functionality when the documents are opened. The extra functionality makes the following activities possible:
Saving forms with results offline Connecting forms to databases or online services Attaching files and media clips Saving copies of documents with changes intact

JavaScript 9

Submitting completed documents electronically Digitally signing documents Sharing documents with others to review and add comments using intuitive markup tools such as electronic sticky notes, highlights, and text strike-throughs
Note: With LiveCycle Reader Extensions, it is not necessary to distribute any plug-ins or other special software to implement these features. For more information on the Adobe LiveCycle products, see the Developer FAQ.

JavaScript

JavaScript is a platform-independent scripting language with which you can customize the behavior of PDF documents in Acrobat or Adobe Reader, as well as the behavior of Acrobat or Adobe Reader itself. You will find that using JavaScript is, in many cases, much easier than writing plug-ins. Note: Adobe Reader support for JavaScript is limited. For details, see JavaScript APIs on page 10.
Interapplication communication
Acrobat and Adobe Reader provide support for interapplication communication (IAC) through OLE automation and DDE on Windows platforms, and through Apple events and AppleScript on Mac OS. IAC is only supported on Windows and Mac OS platforms, and is not supported on Linux or UNIX platforms. Note: Adobe Reader support for IAC is limited. For details, see Interapplication Communication on page 25.

Plug-ins

Plug-ins are dynamically linked extensions to Acrobat or Adobe Reader, and can be developed on all supported platforms. A plug-in can extend or customize the functionality of Acrobat or Adobe Reader, and can be integrated into the user interface. Plug-ins are written in ANSI C/C++ using the Acrobat APIs. In order to write a plug-in for Adobe Reader, you must create a Reader-enabled plug-in. Note: Adobe Reader support for the Acrobat core and extended APIs is limited. For details, see Plug-ins on page 28.

JavaScript APIs

With Adobe Reader, JavaScript can be used for a number of tasks:
To develop and process Acrobat forms and XML forms To customize the behavior and appearance of a PDF document To facilitate online team review To implement security policies To interact with web services To customize the behavior and appearance of Adobe Reader itself
Note: The JavaScript debugger available in Acrobat is not normally available in Adobe Reader, though debug messages can be triggered to appear in the console. The complete debugger functionality can be enabled in Adobe Reader on Windows and Mac OS platforms. For details, see Developing Acrobat Applications using JavaScript. As you learned in Technologies available within the Acrobat SDK on page 8, additional usage rights may be applied to a PDF document using LiveCycle Reader Extensions. For detailed information on which JavaScript APIs are available in rights-enabled PDF documents, see Developing Acrobat Applications using JavaScript.
Objects, properties and methods
On all supported platforms, JavaScript can be used for processing within a single document, processing for a given page within a document, and processing for a given form field. The following table JavaScript objects, properties, and methods available in Adobe Reader contains a list of the JavaScript objects, properties, and methods that can be used with Adobe Reader. Note: Some of the objects listed below, such as those related to the console, debugger, media players, and text-to-speech, are not available for all platforms. Also, many properties and methods are only available within certain contexts and circumstances. For details, see the JavaScript for Acrobat API Reference and Developing Acrobat Applications using JavaScript.
JavaScript objects, properties, and methods available in Adobe Reader

Object

Alerter AlternatePresentation Annotation active type alignment AP arrowBegin arrowEnd attachIcon

Properties

Methods
dispatch start stop destroy getProps getStateInModel setProps transitionToState
Objects, properties and methods 11

Annotation

author borderEffectIntensity borderEffectStyle callout caretSymbol contents creationDate dash delay doc doCaption fillColor gestures hidden inReplyTo intent leaderExtend leaderLength lineEnding lock modDate name noteIcon noView opacity page point points popupOpen popupRect print quads rect readOnly refType richContents richDefaults rotate seqNum soundIcon state stateModel strokeColor style subject textFont textSize toggleNoView type vertices width

(Continued)

Objects, properties and methods 12

Annot3D

activated context3D innerRect name page rect activeDocs calculate constants focusRect formsVersion fromPDFConverters fs fullscreen language media monitors numPlugIns openInPlace platform plugIns printerNames runtimeHighlight runtimeHighlightColor thermometer toolbar toolbarHorizontal toolbarVertical viewerType viewerVariation viewerVersion
addMenuItem addSubMenu addToolButton alert beep beginPriv browseForDoc clearInterval clearTimeOut endPriv execDialog execMenuItem getNthPlugInName getPath goBack goForward hideMenuItem hideToolbarButton launchURL listMenuItems listToolbarButtons openDoc popUpMenu popUpMenuEx removeToolButton response setInterval setTimeOut trustedFunction trustPropagatorFunction addStockEvents alertFileNotFound alertSelectFailed argsDWIM canPlayOrAlert computeFloatWinRect constrainRectToScreen createPlayer getAltTextData getAltTextSettings getAnnotStockEvents getAnnotTraceEvents getPlayers

app.media

align canResize closeReason defaultVisible ifOffScreen layout monitorType openCode over pageEventNames raiseCode raiseSystem renditionType
Objects, properties and methods 13
status trace version windowType
getPlayerStockEvents getPlayerTraceEvents getRenditionSettings getURLData getURLSettings getWindowBorderSize openPlayer removeStockEvents startPlayer execute

Bookmark

children doc parent binary issuerDN keyUsage MD5Hash SHA1Hash serialNumber subjectCN subjectDN ubRights usage

Certificate

Collab
addStateModel documentToStream removeStateModel transparent black white red green blue cyan magenta yellow dkGray gray ltGray columnNum name type typeName value name description type typeName convert equal

Column

ColumnInfo
Objects, properties and methods 14

console

clear hide println show
Note: Only println is supported on Linux and UNIX platforms.
Data creationDate description MIMEType modDate name path size enable end load store info canList canDoCustomSearch canDoCustomUISearh canDoStandardSearch groups name uiName alternatePresentations author baseURL bookmarkRoot calculate creationDate creator dataObjects delay disclosed docID documentFileName dynamicXFAForm external fileSize hidden hostContainer icons info innerAppWindowRect innerDocWindowRect isModal connect search

Dialog

Directory DirConnection

Document

addAnnot addField addIcon bringToFront calculateNow closeDoc createDataObject deletePages embedDocAsDataObject exportAsFDF exportAsFDFStr exportAsText exportAsXFDF exportAsXFDFStr exportDataObject exportXFAData getAnnot getAnnot3D getAnnots getAnnots3D getDataObject getDataObjectContents
Objects, properties and methods 15
keywords layout media modDate mouseX mouseY noautocomplete nocache numFields numPages numTemplates path outerAppWindowRect outerDocWindowRect pageNum pageWindowRect permStatusReady producer requiresFullSave securityHandler selectedAnnots sounds spellDictionaryOrder subject templates URL viewState xfa XFAForeground zoom zoomType
getField getIcon getLinks getNthFieldName getNthTemplate getOCGs getOCGOrder getPageBox getPageLabel getPageNthWord getPageNthWordQuads getPageNumWords getPageRotation getPageTransition getPrintParams getSound getTemplate getURL gotoNamedDest importAnFDF importAnXFDF importDataObject importIcon importSound importTextData importXFAData mailDoc mailForm openDataObject print removeDataObject removeField resetForm saveAs scroll selectPageNthWord setDataObjectContents setPageAction submitForm syncAnnotScan deleteRendition getAnnot getAnnots getOpenPlayers getRendition newPlayer postMessage

Doc.media

canPlay

Embedded PDF

messageHandler
Objects, properties and methods 16
fileName lineNumber extMessage message name change changeEx commitKey fieldFull keyDown modifier name rc richChange richChangeEx richValue selEnd selStart shift source target targetName type value willCommit

toString

Events
add dispatch remove afterBlur afterClose afterDestroy afterDone afterError afterEscape afterEveryEvent afterFocus afterPause afterPlay afterReady afterScript afterSeek afterStatus afterStop onBlur onClose onDestroy onDone onError onEscape onEveryEvent

EventListener

Objects, properties and methods 17
onFocus onGetRect onPause onPlay onReady onScript onSeek onStatus onStop
alignment borderStyle buttonAlignX buttonAlignY buttonFitBounds buttonPosition buttonScaleHow buttonScaleWhen calcOrderIndex charLimit comb commitOnSelChange currentValueIndices defaultStyle defaultValue doNotScroll doNotSpellCheck delay display doc editable exportValues fileSelect fillColor hidden highlight lineWidth multiline multipleSelection name numItems page password print radiosInUnison readonly rect required richText richValue strokeColor style
browseForFileToSubmit buttonGetCaption buttonGetIcon buttonSetCaption buttonSetIcon checkThisBox clearItems defaultIsChecked deleteItemAt getArray getItemAt getLock insertItemAt isBoxChecked isDefaultChecked setFocus setItems signatureGetModifications signatureGetSeedValue signatureInfo signatureSign signatureValidate

Objects, properties and methods 18
submitName textColor textFont textSize type userName value valueAsString backgroundColor clickAdvances cursor defaultTransition escapeExits isFullScreen loop timeDelay transitions usePageTiming useTimer

FullScreen

Global HostContainer Icon Icon Stream messageHandler name read width height corporation email loginName name available name path selected frame index name time player
setPersistent subscribe postMessage

Identity

Marker

Markers

Objects, properties and methods 19

MediaOffset

frame marker time annot defaultSize doc events hasFocus id innerRect isOpen isPlaying markers outerRect page settings uiSize visible rendition selectContext players rejects rendition autoPlay baseURL bgColor bgOpacity data duration endAt floating layout monitor monitorType page palindrome players rate repeat showUI startAt visible volume windowType

MediaPlayer

close open pause play seek setFocus stop triggerGetRect where
MediaReject MediaSelection

MediaSettings

Objects, properties and methods 20

Monitor

colorDepth isPrimary rect workRect

Monitors

(Same as Array)
bestColor bestFit desktop document filter largest leastOverlap mostOverlap nonDocument primary secondary select tallest widest getIntent setAction
constants initState locked name state id mimeTypes name version

PlayerInfo

canPlay canUseData honors select

PlayerInfoList PlugIn

certfied loaded name path version
Objects, properties and methods 21

PrintParams

binaryOK colorOverride constants downloadFarEastFonts fileName firstPage flags fontPolicy interactive lastPage nUpAutoRotate nUpNumPagesH nUpNumPagesV nUpPageBorder nUpPageOrder pageHandling pageSubset printAsImage printContent printerName psLevel reversePages usePrinterCRD useT1Conversion c cn o ou e altText doc fileName type uiName columnArray altText alwaysShowFocus display doc events extFocusRect innerDeviceRect noTrigger outerDeviceRect page player rect

Rendition

getPlaySettings select testCriteria

Row ScreenAnnot

hasFocus setFocus
Objects, properties and methods 22

Search

attachments available bookmarks docInfo docText docXMP ignoreAccents ignoreAsianCharacterWidth indexes jpegExif legacySearch markup matchCase matchWholeWord maxDocs objectMetadata proximity proximityRange refine soundex stem thesaurus wordMatching handlers appearances digitalIDs directories directoryHandlers isLoggedIn loginName loginPath name signAuthor signFDF signInvisible signValidate signVisible uiName
addIndex getIndexForPath query removeIndex

Security SecurityHandler

getHandler login logout newDirectory

SignatureInfo

(see the JavaScript for Acrobat API Reference for a detailed description of the properties)
Objects, properties and methods 23

wiredump

connect queryServices resolveService request response streamDecode streamDigest streamEncode streamFromString stringFromStream play pause stop
alignment fontFamily fontStretch fontStyle fontWeight strikethrough subscript superscript text textColor textSize underline available dictionaryNames dictionaryOrder domainNames languages languageOrder addWord check checkText checkWord customDictionaryClose customDictionaryOpen ignoreAll removeWord userWords spawn begin end

Template Thermometer

hidden name cancelled duration text value
Objects, properties and methods 24
available numSpeakers pitch soundCues speaker speechCues speechRate volume
getNthSpeakerName pause qSilence qSound qText reset resume stop talk crackURL iconStreamFromIcon printd printf printx scand spansToXML streamFromString stringFromStream xmlToSpans
(Corresponds to the appModel container. For details, see Developing Acrobat Applications using JavaScript.)
(Corresponds to the appModel container. For details, see Developing Acrobat Applications using JavaScript)

applyXPath parse

XMLData
For a complete description of the capabilities and usage of JavaScript for Acrobat, see Developing Acrobat Applications using JavaScript and the JavaScript for Acrobat API Reference.
Interapplication Communication
Only a limited subset of the complete IAC functionality is available for Adobe Reader. For detailed descriptions of the syntax and usage of the IAC APIs discussed in this chapter, see the Interapplication Communication API Reference and Developing Applications using Interapplication Communication. Note: IAC is not supported on the Linux or UNIX platforms.

OLE automation

On Windows, the only OLE automation supported for Adobe Reader is the PDF browser controls interface, which enables you to treat a PDF document as an ActiveX document within an external application. This makes it possible to load a file, move to various pages within the file, highlight a text selection, and specify various print and display options, as shown below.

PDF browser controls

OLE automation 26
PDF browser controls are available through the AxAcroPDFLib.AxAcroPDF interface, which provides the following methods used to programmatically control the PDF document window:

GoBackwardStack GoForwardStack GotoFirstPage GotoLastPage GotoNextPage GotoPreviousPage LoadFile Print PrintAll PrintAllFit PrintPages PrintPagesFit PrintWithDialog SetCurrentHighlight SetCurrentPage SetLayoutMode SetNamedDest SetPageMode SetShowScrollbars SetShowToolbar SetView SetViewRect SetViewScroll SetZoom SetZoomScroll

DDE messages 27

DDE messages
Adobe Reader supports the following DDE messages:

AppExit CloseAllDocs DocClose DocGoTo DocGoToNameDest DocOpen FileOpen FileOpenEx FilePrint FilePrintEx FilePrintSilent FilePrintSilentEx FilePrintTo FilePrintToEx

Apple events

On Mac OS, you may use Apple events and AppleScript. Adobe Reader supports only the following required Apple events:

open print quit run

The Acrobat core and extended APIs enable you to write plug-ins that integrate with Adobe Reader. For detailed information on the API architecture, methods, and usage, see Developing Plug-ins and Applications and the Acrobat and PDF Library API Reference. Any plug-ins written for Adobe Reader must be Reader-enabled, which means that you will need to obtain permission and licensing from Adobe Systems. When developing a Reader-enabled plug-in, follow the steps described in Developing Plug-ins and Applications to make specific changes to your plug-in code in order for Adobe Reader to recognize and load it. For information on what you can and cannot do with Reader-enabled plug-ins, see the Reader Integration Key License Program. A Reader-enabled plug-in is a dynamically linked extension to Adobe Reader created using C/C++ APIs, and can be developed for any supported platform:
DLLs on Windows (using the extension.api) Shared libraries (code fragments) on Mac OS X Shared libraries on Linux or UNIX platforms
As you learned in Technologies available within the Acrobat SDK on page 8, additional usage rights may be applied to a PDF document using LiveCycle Reader Extensions. For information on checking permissions associated with a given PDF document, see Developing Plug-ins and Applications. Note: With LiveCycle Reader Extensions, it is not necessary to distribute any plug-ins or other special software to implement the additional usage rights available within the PDF document.
APIs available for Adobe Reader 29

APIs available for Adobe Reader
Host Function Tables (HFTs) are tables of function pointers, essentially providing a means by which plug-ins call methods in Adobe Reader. The following HFTs are available for development with Adobe Reader:
AcroView AcroViewSweetPea Cos PDModel ASExtra PDSRead AcroSupport Core Forms TTS DigSigHFT AcroHLS (Not available on Linux or UNIX platforms) PubSecHFT Search WebLink
For details about specific API support within each of the HFTs, see Developing Plug-ins and Applications. For information about the various Acrobat layers and the organization of the related HFTs, see the Acrobat and PDF Library API Reference. For a summary of the Acrobat extended APIs, see the Acrobat and PDF Library API Reference. For details regarding the additional usage rights that may be applied to a PDF document, see Developing Plug-ins and Applications.
ActiveX document 25 additional usage rights 8, 10, 28 Adobe LiveCycle Reader Extensions 8, 10, 28 AIX 6, 8 Apple events 9, 25 AppleScript 9, 27

Mac OS 6 Macintosh 6

OLE automation 9, 25

DDE 9 DDE messages 27

PDF browser controls 25 Plug-ins 9 plug-ins 28

HP-UX 6, 8

Reader-enabled plug-in 9, 28 rights-enabled 8, 10
IAC 25 Interapplication Communication 9
Solaris 6, 7 supported platforms 6
JavaScript 9, 10 JavaScript debugger 10

Windows 6

Linux 6, 7