Create an annotation in a PDF using C#

To create an annotation in a PDF document, follow the steps below:

  1. Create a GdPicturePDF object.
  2. Load the PDF file with the LoadFromFile method.
  3. Set the origin of the coordinate system with the SetOrigin method. This method requires the PDFOrigin enumeration.
  4. Set the measurement unit with the SetMeasurementUnit method to specify the annotation’s dimensions and position. This method uses the PdfMeasurementUnit enumeration.
  5. Select the PDF page where you want to place the annotation using the SelectPage method.
  6. Optional: Specify the font type. For more information, refer to the Font Type section of the guide on adding text to PDFs.
  7. Add the annotation with any of the following methods:
  8. Save the PDF document to a file with the SaveToFile method.

All methods that create a new annotation return an integer value, which is the annotation’s index. Recommended: Save the annotation index to a variable so that you can later reference that annotation.

using GdPicturePDF gdpicturePDF = new GdPicturePDF();
gdpicturePDF.LoadFromFile(@"C:\temp\source.pdf");
// Set the origin of the coordinate system.
gdpicturePDF.SetOrigin(PdfOrigin.PdfOriginTopLeft);
// Set the measurement unit to centimeters.
gdpicturePDF.SetMeasurementUnit(PdfMeasurementUnit.PdfMeasurementUnitCentimeter);
// Select the first PDF page.
gdpicturePDF.SelectPage(1);
// Set the text content and determine its size.
float fontSize = 16;
string fontResName = gdpicturePDF.AddStandardFont(PdfStandardFont.PdfStandardFontHelvetica);
string text = "Text annotation example.";
float textWidth = gdpicturePDF.GetTextWidth(fontResName, fontSize, text);
float textHeight = gdpicturePDF.GetTextHeight(fontResName, fontSize, false);
// Add the free text annotation.
int annotIndex = gdpicturePDF.AddFreeTextAnnotation(1, 2, textWidth + 0.5f, textHeight + 0.5f, true,
    "Annotation Example", "Example", text,
    fontResName, fontSize, 0, 0, 200, 100, 100, 100, 100);
gdpicturePDF.SaveToFile(@"C:\temp\output.pdf");

Used methods

Related topics