Adobe acrobat 7.0.5 sdk User Manual

Page of 122
69
Using Online Collaboration and Annotations
Using Annotations in Document Workflows
7
Using Annotations in Document Workflows
An annotation associates an object such as a note, sound, or movie with a location on a 
page of a PDF document, or provides a way to interact with the user via the mouse and 
keyboard. PDF includes a wide variety of standard annotation types, described in detail in 
the PDF 1.6 Reference.
Many of the standard annotation types can be displayed in either the open or the closed 
state. When closed, they appear on the page in some distinctive form depending on the 
specific annotation type, such as an icon, a box, or a rubber stamp. When the user activates 
the annotation by clicking it with the mouse, it exhibits its associated object, such as 
opening a pop-up window displaying a text note or playing a sound or a movie.
You can access and manipulate annotation data from both a plug-in and Acrobat 
JavaScript. However, you can only create new annotation types using a plug-in or the IAC 
API; you cannot create new annotation types from JavaScript.
Annotations and JavaScript
You can set, modify and access annotation information using the Acrobat JavaScript 
annot
 object. However, you cannot create a new annotation type from JavaScript. To do 
this, you must use a plug-in or the IAC API.
Using the annot object, you can:
Add note comments
Make text edits
Highlight, cross out, or underline text
Add or delete custom stamps (see 
Add comments in a text box
Add attachments
Spell check in comments and forms (see 
)
Add commenting preferences
Change colors, icons, and other comment properties