Annotations Overview
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 through the mouse and keyboard. PDF includes a wide variety of standard annotation types. 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, such as an icon, a box, or a rubber stamp, depending on the specific annotation type. When the user activates the annotation by clicking it, it exhibits its associated object, such as by opening a pop-up window displaying a text note or by playing a sound or a movie.
RadPdfProcessing provides an exception handling mechanism that allows you to detect cases with not valid or unsupported annotations during import.
The abstract Annotation element associates an object with a location on a RadFixedPage. Annotation exposes the following properties:
| Property | Description |
|---|---|
Rect | The rectangle that defines the location of the annotation on the page. |
Type | Of type AnnotationType, this property determines the type of the annotation. The supported types are listed in the following table. |
Border | Represents the annotation borders. Of type AnnotationBorder, which uses an AnnotationBorderStyle. |
IsPrintable | Indicates whether the annotation is visualized when printing the document. When false, the annotation does not appear when the document is printed. |
The following table lists the supported annotation types:
| Annotation Type | Description |
|---|---|
| Link | A link annotation represents either a hypertext link to a destination elsewhere in the document or an action to perform. |
| Widget | Interactive forms use widget annotations to represent the appearance of fields and to manage user interactions. |
| Text | A text annotation represents a sticky note attached to a point in the PDF document. |
| Line | Line annotations display a single straight line on the page. |
| Stamp | Stamp annotations display text or graphics intended to look as if they were stamped on the page with a rubber stamp. |
| TextMarkup | Text markup annotations appear as highlights, underlines, strikeouts, or squiggly underlines in the text of a document. When opened, they display a pop-up window containing the text of the associated note. |
| Popup | A popup annotation is associated with another markup annotation and displays its content in a pop-up window for entry and editing. It typically appears as a pop-up note. |