# Text Annotation

A **Text annotation** represents a *sticky note* attached to a point in the PDF document. When closed, the annotation appears as an icon. When opened, it displays a pop-up window containing the text of the note in a font and size chosen by the viewer application.

> note Text annotations do not scale and rotate with the page. They behave as if the `NoZoom` and `NoRotate` annotation flags were always set.

The `TextAnnotation` class is a derivative of `MarkupAnnotation` (descendent of `ContentAnnotation`) and it exposes the following properties:

| Property   | Description                                                                                                                                                                                                                                                |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Opacity`  | Gets or sets the opacity of the annotation.                                                                                                                                                                                                                |
| `Contents` | Gets or sets the text displayed for the annotation.                                                                                                                                                                                                        |
| `Color`    | Gets or sets the color of the annotation.                                                                                                                                                                                                                  |
| `Content`  | Gets the source defining the visual content of the annotation. This content has higher priority compared to the annotation appearance characteristics and text properties and is visualized by default when opening the exported document in a PDF viewer. |

## Creating a TextAnnotation

```C#
string sampleText = "sample text here";
RadFixedDocument fixedDocument = new RadFixedDocument();
using (RadFixedDocumentEditor editor = new RadFixedDocumentEditor(fixedDocument))
{
    editor.InsertRun(sampleText);
}

RadFixedPage page = fixedDocument.Pages[0];
TextAnnotation annotation = page.Annotations.AddText(new Rect(200, 100, 200, 200));
annotation.Contents = "This is a TextAnnotation";
annotation.Opacity = 0.5;
annotation.Color = new RgbColor(255, 0, 0); //Default RgbColor(255, 255, 255)
```

![Create TextAnnotation](https://www.telerik.com/document-processing-libraries/documentation/assets/d6f6fbfcc5a07cacad3abb9b78583edb/pdf-processing-create-textannotation.png)

## Creating a TextAnnotation with FixedContentEditor

The `FixedContentEditor` offers the public `DrawTextAnnotation` method which creates a new `TextAnnotation` and draws it with a specified size and text. It can also create a `PopupAnnotation` to associate with it.

```C#
RadFixedDocument fixedDocument = new RadFixedDocument();
FixedContentEditor editor = new FixedContentEditor(fixedDocument.Pages.AddPage());
editor.Position.Translate(100, 100);
Size annotationSize = new Size(50, 50);
Size popupSize = new Size(250, 100);
string text = "This is a TextAnnotation";
bool addPopup = true;
editor.DrawTextAnnotation(annotationSize, popupSize, text, addPopup);
PopupAnnotation popupAnnotation = fixedDocument.Pages[0].Annotations[1] as PopupAnnotation;
```

![Create TextAnnotation with Popup](https://www.telerik.com/document-processing-libraries/documentation/assets/f43c2b5d84ad0b2dc56a3c39506c0f8f/pdf-processing-create-textannotation-with-popup.png)

## Creating a TextAnnotation with Appearance

The `AnnotationContentSource` class, accessed by the `Content` property of the annotation object, represents the [FormSource](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/model/formsource/overview) instances used for displaying the widget content. The following example shows how to change the annotation visual appearance when the mouse is not interacting with the widget (`NormalContentSource`) and when the mouse is over the widget (`MouseOverContentSource`):

> important In **.NET Standard/.NET (Target OS: None)** environments, fonts beyond the [14 standard ones](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/concepts/fonts#standard-fonts) require a [FontsProvider implementation](https://www.telerik.com/document-processing-libraries/documentation/knowledge-base/pdfprocessing-implement-fontsprovider) to be resolved correctly.

```C#
private RadFixedDocument CreateTextAnnotation()
{
    RadFixedDocument fixedDocument = new RadFixedDocument();
    RadFixedPage page = fixedDocument.Pages.AddPage();

    TextAnnotation annotation = page.Annotations.AddText(new Rect(100, 100, 100, 50));
    annotation.Contents = "This is a TextAnnotation";
    FormSource normalForm = new FormSource();
    CreateContentFormWithText(normalForm, "Hover me");
    FormSource hoverForm = new FormSource();
    CreateContentFormWithText(hoverForm, "Done");

    annotation.Content.NormalContentSource = normalForm;
    annotation.Content.MouseOverContentSource = hoverForm;
    return fixedDocument;
}

private static void CreateContentFormWithText(FormSource normalForm, string text)
{
    Size s = new Size(100, 40);
    Random rand = new Random();
    normalForm.Size = s;

    FixedContentEditor formEditor = new FixedContentEditor(normalForm);

    using (formEditor.SaveProperties())
    {
        formEditor.GraphicProperties.IsFilled = true;
        formEditor.GraphicProperties.IsStroked = true;
        formEditor.GraphicProperties.StrokeThickness = 1;
        formEditor.GraphicProperties.StrokeColor = new RgbColor(255, 0, 0);
        formEditor.GraphicProperties.FillColor = new RgbColor(255, 255, 0);
        formEditor.GraphicProperties.StrokeDashArray = new double[] { 17, 4 };
        formEditor.DrawRectangle(new Rect(0, 0, s.Width, s.Height));
    }

    formEditor.TextProperties.FontSize = 10;
    formEditor.TextProperties.Font = FontsRepository.Courier;
    formEditor.Position.Translate(10, 10);
    formEditor.DrawText(text);
}
```

![Create TextAnnotation with Appearance](https://www.telerik.com/document-processing-libraries/documentation/assets/6d019a182716e0147ba0ec4ddf7e44a3/pdf-processing-create-textannotation-with-appearance.gif)

You can also modify the content source displayed when the mouse button is pressed on the widget through the `MouseDownContentSource` property of `AnnotationContentSource`.

## See Also

* [AcroForm](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/model/interactive-forms/acroform)
* [FormField](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/model/interactive-forms/form-fields/formfields)
* [Annotations Overview](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/model/annotations/overview)
* [FormSource](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/model/formsource/overview)