Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion libraries/radpdfprocessing/model/annotations/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,8 @@ The abstract **Annotation** element associates an object with a location on a [R
|[Line]({%slug radpdfprocessing-model-annotations-line%})|Line annotations display a single straight line on the page.|
|[Stamp]({%slug radpdfprocessing-model-annotations-stamp%})|Stamp annotations display text or graphics intended to look as if they were stamped on the page with a rubber stamp.|
|[TextMarkup]({%slug radpdfprocessing-model-annotations-text-markup%})| 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]({%slug radpdfprocessing-model-annotations-popup%})|A popup annotation is associated with another [markup annotation]({%slug radpdfprocessing-model-annotations-overview%}) and displays its content in a pop-up window for entry and editing. It typically appears as a pop-up note.|
Copy link

Copilot AI May 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] Consider clarifying that the popup annotation is initially hidden and only becomes visible when activated to more accurately reflect its behavior.

Copilot uses AI. Check for mistakes.

* **Border**: Represents the annotation borders. This property is of type [AnnotationBorder](https://docs.telerik.com/devtools/document-processing/api/Telerik.Windows.Documents.Fixed.Model.Annotations.AnnotationBorder.html).

* **IsPrintable**: A boolean value that indicates whether the annotation instance should be visualized when printing the document. When set to *false*, the annotation won't appear when the document is printed.
Expand Down
45 changes: 45 additions & 0 deletions libraries/radpdfprocessing/model/annotations/popup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
---
title: Popup
Copy link

Copilot AI May 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[nitpick] Consider updating the title metadata to 'Popup Annotation' to match the page title and ensure consistency across the documentation.

Copilot uses AI. Check for mistakes.
page_title: Popup Annotation
description: Popup annotations display a pop-up window containing comments or notes associated with the document content.
slug: radpdfprocessing-model-annotations-popup
tags: annotation, overview, pdfprocessing, popup
published: True
position: 7
---

# Popup Annotation

A **Popup annotation** displays a pop-up window containing text associated with a parent annotation, such as a [Text]({%slug radpdfprocessing-model-annotations-text%}), [Line]({%slug radpdfprocessing-model-annotations-line%}), [TextMarkup]({%slug radpdfprocessing-model-annotations-text-markup%}) or [Stamp]({%slug radpdfprocessing-model-annotations-stamp%}) annotation. When closed, a popup annotation is invisible. When open, it should appear as a pop-up window at a specified location on the page.

The **PopupAnnotation** class is a derivative of the **Annotation** class and it exposes the following properties:

|Property|Description|
|---|---|
|**ParentAnnotation**|Gets or sets the parent [MarkupAnnotation]({%slug radpdfprocessing-model-annotations-overview%}) that this popup is associated with.|
|**IsOpen**|Gets or sets a value indicating whether the popup is initially open.|

## Creating a PopupAnnotation

Popup annotations are typically created in association with another markup annotation, such as Text, Line, TextMarkup or Stamp. The following example shows how to create a PopupAnnotation associated with a TextAnnotation:

<snippet id='libraries-pdf-model-annotations-popup-create'/>

The popup annotation will display the contents of the text annotation in a pop-up window.

## Creating a PopupAnnotation with FixedContentEditor

When creating a TextAnnotation with the [FixedContentEditor]({%slug radpdfprocessing-editing-fixedcontenteditor%})'s **DrawTextAnnotation** method, you can also associate a popup annotation by setting the `addPopup` parameter to **true**:

<snippet id='libraries-pdf-model-annotations-popup-create-with-fixedcontenteditor'/>

This code creates a [TextAnnotation]({%slug radpdfprocessing-model-annotations-text%}) with an associated **PopupAnnotation**. The popup will display the text provided in the method call.

## See Also

* [Annotations Overview]({%slug radpdfprocessing-model-annotations-overview%})
* [Text Annotation]({%slug radpdfprocessing-model-annotations-text%})
* [Line Annotation]({%slug radpdfprocessing-model-annotations-line%})
* [TextMarkup Annotation]({%slug radpdfprocessing-model-annotations-text-markup%})
* [Stamp Annotation]({%slug radpdfprocessing-model-annotations-stamp%})
* [FixedContentEditor]({%slug radpdfprocessing-editing-fixedcontenteditor%})