Table of Contents
Advertisement
8
Creating Annotations
This chapter explains how to create new annotations and modify existing ones. Annotations are tools that
let you electronically collaborate within Adobe Reader or Acrobat, similar to the way people traditionally
collaborate using paper by adding comments, highlights, sticky notes, and so on. For example, the note
annotation enables Adobe Reader or Acrobat users to add notes within a PDF document that other
viewers can read.
This chapter contains the following information.
Topic
About annotations
Creating text annotations
Retrieving existing annotations
Modifying text annotations
About annotations
The Acrobat core API provides methods for working with annotations in PDF documents. Annotations are
represented by a
Several annotation types exist, which are identified by their subtype. Each subtype can have additional
properties that extend the basic ones. The subtype for text annotations (also called notes) is text. The
subtype for link annotations is link. The Acrobat core API contains two built-in annotation typedefs
PDTextAnnot
PDLinkAnnot
You can use
and subtype. For example, you can invoke the
Note:
This chapter does not discuss how to create 3D annotations. For information, see
Annotations" on page
Creating text annotations
You can create a text annotation by performing the following tasks:
1. Create a rectangle region that specifies the annotation's location. To create a rectangle region, create
an
ASFixedRect
2. Define the rectangle's borders by setting the
3. Create an
the
PDDocAcquirePage
represents the page number. This method returns an
typedef, which is the abstract superclass for all annotations.
PDAnnot
and
PDLinkAnnot
object corresponds to a link annotation.
methods to get and set various annotation properties, such as color, date, title, location,
PDAnnot
203.
object.
object that represents the page that will contain the new annotation by invoking
ASPage
method. This method requires a
Description
Describes the characteristics of annotations.
Describes how to create text annotations.
Describes how to retrieve existing text annotations.
Describes how to modify existing annotations.
. A
object corresponds to a text annotation and a
PDTextAnnot
PDAnnotSetColor
ASFixedRect
ASPage
method to set the color of an annotation.
object's left, top, right, and bottom attributes.
object and the
PDDoc
ASInt32
object.
See
page 108
page 108
page 110
page 111
"Creating 3D
object that
108
Advertisement
Table of Contents
