Adobe acrobat 7.0.5 sdk User Manual

Page of 122
49
Working with PDF Documents
Adding Navigation to PDF Documents
5
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
A bookmark corresponds to an outline object in a PDF document. A document outline 
consists of a tree-structured hierarchy of bookmarks that displays the document’s structure, 
allowing the user to navigate interactively from one part of the document to another. Each 
bookmark has:
A title that appears on screen
An action that specifies what happens when the user clicks on the bookmark
Bookmarks can be either created interactively through the Acrobat user interface or 
generated programmatically. Typically, a user-created bookmark is used to move to 
another location in the current document, although other actions can be specified, such as 
opening a web link, opening a file, playing a sound or executing a JavaScript script.
Each bookmark in the bookmark tree structure has zero or more children that appear 
indented, and zero or more siblings that appear at the same indentation level. All 
bookmarks except the bookmark at the top level of the hierarchy have one parent, the 
bookmark under which it is indented. A bookmark is said to be open if its children are 
visible, and closed if they are not. 
You can use Acrobat JavaScript, a plug-in, or IAC to get or set: 
The open attribute of a bookmark
The text used for the bookmark’s title
The action that is invoked when the bookmark is selected
The object associated with each Acrobat SDK technology is shown below:
JavaScript
Bookmark
Plug-in
PDBookmark
IAC
AcroExch.PDBookmark