# Stamp Annotation

A **Stamp annotation** displays text or graphics intended to look as if they were stamped on the page with a rubber stamp. When opened, it displays a pop-up window containing the text of the associated note.

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

| Property   | Description                                                                                                                                                                                                                                                              |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Name`     | Gets or sets the name of the stamp. The name can be chosen from the predefined names in the `StampAnnotationPredefinedNames` class or it can be a custom string. In the case of a custom string, provide an appearance through the `ContentAnnotation.Content` property. |
| `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 StampAnnotation

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

StampAnnotation annotation1 = page.Annotations.AddStamp(new Rect(50, 50, 300, 50));
annotation1.Name = StampAnnotationPredefinedNames.SBApproved;

StampAnnotation annotation2 = page.Annotations.AddStamp(new Rect(50, 100, 300, 50));
annotation2.Name = StampAnnotationPredefinedNames.SBPreliminaryResults;

StampAnnotation annotation3 = page.Annotations.AddStamp(new Rect(50, 150, 300, 50));
annotation3.Name = StampAnnotationPredefinedNames.SBRejected;

StampAnnotation annotation4 = page.Annotations.AddStamp(new Rect(50, 200, 300, 50));
annotation4.Name = StampAnnotationPredefinedNames.SBVoid;
```

![Create StampAnnotation](https://www.telerik.com/document-processing-libraries/documentation/assets/063614ed9bc75fc73ec4a5c9e7966694/pdf-processing-create-stampannotation.png)

## Creating a StampAnnotation with FixedContentEditor

The [FixedContentEditor](https://www.telerik.com/document-processing-libraries/documentation/libraries/radpdfprocessing/editing/fixedcontenteditor) offers the public `DrawStampAnnotation` method which creates a new `StampAnnotation` and draws it with a specified annotation size and name.

```C#
RadFixedDocument fixedDocument = new RadFixedDocument();
FixedContentEditor editor = new FixedContentEditor(fixedDocument.Pages.AddPage());

editor.Position.Translate(100, 100);
editor.DrawStampAnnotation(new Size(250, 250), StampAnnotationPredefinedNames.SBFinal);
editor.Position.Translate(400, 100);
editor.DrawStampAnnotation(new Size(250, 250), StampAnnotationPredefinedNames.SBConfidential);
```

![Create StampAnnotation with FixedContentEditor](https://www.telerik.com/document-processing-libraries/documentation/assets/602252e8b9d913416c6c64a7131c77c7/pdf-processing-create-stampannotation-with-fixedcontenteditor.png)

## Creating a StampAnnotation 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 create a custom Stamp annotation and change its visual appearance.

> important When you create a custom stamp name (not from the predefined names), start the name with "#". Otherwise, if the stamp is moved in Adobe, its appearance is rewritten.

> important When you create appearance for an annotation, create it with the same size as the rectangle of the annotation. Otherwise, unexpected behavior can occur when the annotation is moved in Adobe.

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

    StampAnnotation annotation = page.Annotations.AddStamp(new Rect(100, 100, 300, 100));
    annotation.Name = "#Sold";

    FormSource simpleForm = new FormSource();
    CreateContentFormWithText(simpleForm, "Sold");

    annotation.Content.NormalContentSource = simpleForm;
    return fixedDocument;
}

private static void CreateContentFormWithText(FormSource normalForm, string text)
{
    normalForm.Size = new Size(300, 100);

    FixedContentEditor formEditor = new FixedContentEditor(normalForm);

    using (formEditor.SaveProperties())
    {
        formEditor.GraphicProperties.IsFilled = true;
        formEditor.GraphicProperties.IsStroked = true;
        formEditor.GraphicProperties.StrokeThickness = 2;
        formEditor.GraphicProperties.StrokeColor = new RgbColor(92, 229, 0);
        formEditor.GraphicProperties.FillColor = new RgbColor(213, 222, 226);
        formEditor.GraphicProperties.StrokeDashArray = new double[] { 17, 4 };
        formEditor.DrawRectangle(new Rect(formEditor.Position.Matrix.OffsetX,
            formEditor.Position.Matrix.OffsetY, 300, 100));
    }

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

![Create StampAnnotation with Appearance](https://www.telerik.com/document-processing-libraries/documentation/assets/37d9252d62a365b632b302cd0705854c/pdf-processing-create-stampannotation-with-appearance.png)

> 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.

## 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)