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 by means of the mouse and keyboard. PDF includes a wide variety of standard annotation types. Many of the standard annotation types may 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 which allows detecting cases with invalid or not supported annotations being imported in the document.
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 table below. |
Border | Represents the annotation borders. Of type AnnotationBorder, which uses an AnnotationBorderStyle. |
IsPrintable | Indicates whether the annotation should be visualized when printing the document. When false, the annotation will not appear when the document is printed. |
| Annotation Type | Description |
|---|---|
| Link | A link annotation represents either a hypertext link to a destination elsewhere in the document or an action to be performed. |
| 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. |