PdfTextMarkupAnnotationData Class
Represents a text markup annotation.
Namespace: DevExpress.Pdf
Assembly: DevExpress.Pdf.v22.1.Core.dll
Declaration
Remarks
Create a Text Markup Annotation
Call the PdfDocumentProcessor.AddTextMarkupAnnotation method to create a text markup annotation at the specified page area. If the target area does not contain text, the annotation is not created.
The code sample below highlights text with blue and adds a sticky note at the page corner.
using DevExpress.Pdf;
//...
using (PdfDocumentProcessor processor = new PdfDocumentProcessor())
{
//Load a document:
processor.LoadDocument("..\\..\\Document.pdf");
//Add a text markup annotation at the first page:
PdfTextMarkupAnnotationData textMarkup =
processor.AddTextMarkupAnnotation(1, new PdfRectangle(90, 100, 240, 230),
PdfTextMarkupAnnotationType.Highlight);
if (textMarkup != null)
{
//Specify the annotation properties:
textMarkup.Author = "Bill Smith";
textMarkup.Contents = "Important!";
textMarkup.Color = new PdfRGBColor(0.8, 0.2, 0.1);
}
//Add a sticky note at the first page:
PdfTextAnnotationData textAnnotation =
processor.AddTextAnnotation(1, new PdfPoint(100, 300));
//Specify the annotation parameters:
textAnnotation.Author = "Nancy Davolio";
textAnnotation.Checked = true;
textAnnotation.Color = new PdfRGBColor(0.8, 0.2, 0.1);
textAnnotation.Contents = "Please proofread this document";
textAnnotation.IconName = PdfTextAnnotationIconName.Check;
//Save the result:
processor.SaveDocument("..\\..\\Result.pdf");
}
Access Text Markup Annotations
The PdfDocumentProcessor.GetMarkupAnnotationData method allows you to retrieve all annotations located at the specified page. Use the PdfMarkupAnnotationDataExtensions.AsTextMarkupAnnotation method to obtain text markup annotation. The returned PdfTextMarkupAnnotationData object allows you to change the annotation settings.
The code sample below changes the markup style for annotations made by a specific author and changes the icon for all text annotations:
using DevExpress.Pdf;
using System;
using System.Collections.Generic;
//...
private static void EditAnnotations(PdfDocumentProcessor processor)
{
//Retrieve annotations made by the specified author:
var textMarkups =
processor.GetMarkupAnnotationData(1).
Where(annotation => annotation.Author.Contains("Cardle Anita L"));
foreach (PdfMarkupAnnotationData markup in textMarkups)
{
//Get all text markup annotations from the retrieved list:
PdfTextMarkupAnnotationData pdfTextMarkup =
markup.AsTextMarkupAnnotation();
if (pdfTextMarkup != null)
//Change the annotation's markup type:
pdfTextMarkup.MarkupType = PdfTextMarkupAnnotationType.Squiggly;
}
var annotations = processor.GetMarkupAnnotationData(1);
foreach (PdfMarkupAnnotationData annotation in annotations)
{
//Get all text annotations:
PdfTextAnnotationData textAnnotation = annotation.AsTextAnnotation();
if (textAnnotation != null)
//Change the annotation icon:
textAnnotation.IconName = PdfTextAnnotationIconName.Note;
}
}
Delete Text Markup Annotations
Call the PdfDocumentProcessor.DeleteMarkupAnnotations method to remove all markup annotations from the specified page.
To delete a specific annotation, call the PdfDocumentProcessor.DeleteMarkupAnnotation method. Pass the target PdfMarkupAnnotationData object as a parameter to this method.
This example shows how to delete text markup annotations created by a specific author.
using DevExpress.Pdf;
using System.Linq;
//...
private static void DeleteAnnotations(PdfDocumentProcessor processor)
{
for (int i = 0; i <= processor.Document.Pages.Count; i++)
{
//Remove Borman Aaron Lewis's markup annotations from a page.
processor.DeleteMarkupAnnotations(processor.GetMarkupAnnotationData(i)
.Where(annotation => annotation.Author.Contains("Borman Aaron Lewis")));
}
}
Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the PdfTextMarkupAnnotationData class.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.