Set Free Text Annotation Formatting

Aspose.PDF for .NET is a powerful and easy-to-use PDF document manipulation API that allows you to work with PDF files programmatically in your .NET applications. One of the features provided by Aspose.PDF for .NET is the ability to set free text annotation formatting in PDF documents. In this article, we will walk you through the step-by-step process of setting free text annotation formatting using Aspose.PDF for .NET.

Prerequisites

Before we get started, make sure that you have the following prerequisites:

  • Microsoft Visual Studio 2010 or later
  • Aspose.PDF for .NET
  • Basic knowledge of C#

Step 1: Create a new C# console application

First, create a new C# console application in Microsoft Visual Studio. To create a new console application, select “File” > “New” > “Project” > “Visual C#” > “Console Application” from the main menu.

Step 2: Add reference to Aspose.PDF for .NET

Next, add a reference to Aspose.PDF for .NET in your project. To do this, right-click on your project in the “Solution Explorer” pane, select “Add” > “Reference”, and then browse to the location where you saved the Aspose.PDF for .NET DLL file. Select the DLL file and click “OK” to add the reference to your project.

Step 3: Set up the environment

After adding the reference to Aspose.PDF for .NET, you need to set up the environment. To do this, create a new string variable called “dataDir” and set it to the path of the directory where your PDF document is located. Replace “YOUR DOCUMENT DIRECTORY” in the code below with the actual path of your document directory:

// The path to the documents directory.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Step 4: Open the PDF document

Once you have set up the environment, you can open the PDF document using the following code:

// Open document
Document pdfDocument = new Document(dataDir + "SetFreeTextAnnotationFormatting.pdf");

Replace “SetFreeTextAnnotationFormatting.pdf” with the actual name of your PDF document.

Step 5: Set up default appearance

To set up the default appearance of the free text annotation, you need to instantiate the DefaultAppearance object with the desired font, font size, and color. In this tutorial, we are setting the font to “Arial”, font size to 28, and color to red.

// Instantiate DefaultAppearance object
DefaultAppearance default_appearance = new DefaultAppearance("Arial", 28, System.Drawing.Color.Red);

Step 6: Create a free text annotation

Now that you have set up the default appearance, you can create a free text annotation using the following code:

// Create annotation
FreeTextAnnotation freetext = new FreeTextAnnotation(pdfDocument.Pages[1], new Aspose.Pdf.Rectangle(200, 400, 400, 600), default_appearance);

The above code creates a new free text annotation on the second page of the PDF document. The annotation will be positioned at (200, 400) and will have a width of 400 and a height of 600.

Step 7: Specify the contents of the annotation

After creating the free text annotation, you can specify the contents of the annotation using the following code:

// Specify the contents of annotation
freetext.Contents = "Free Text

Example source code for Set Free Text Annotation Formatting using Aspose.PDF for .NET

// The path to the documents directory.
string dataDir = "YOUR DOCUMENT DIRECTORY";

// Open document
Document pdfDocument = new Document(dataDir + "SetFreeTextAnnotationFormatting.pdf");

// Instantiate DefaultAppearance object
DefaultAppearance default_appearance = new DefaultAppearance("Arial", 28, System.Drawing.Color.Red);
// Create annotation
FreeTextAnnotation freetext = new FreeTextAnnotation(pdfDocument.Pages[1], new Aspose.Pdf.Rectangle(200, 400, 400, 600), default_appearance);
// Specify the contents of annotation
freetext.Contents = "Free Text";
// Add anootation to annotations collection of page
pdfDocument.Pages[1].Annotations.Add(freetext);
dataDir = dataDir + "SetFreeTextAnnotationFormatting_out.pdf";
// Save the updated document
pdfDocument.Save(dataDir);

Conclusion

In this tutorial, we learned how to set free text annotation formatting in a PDF document using Aspose.PDF for .NET. The library provides a straightforward and efficient way to work with PDF documents programmatically, allowing developers to create and customize various types of annotations, including free text annotations. By following the step-by-step guide and using the provided C# source code, you can easily set up the environment, open a PDF document, and create a free text annotation with custom formatting. Aspose.PDF for .NET is a robust and reliable API that simplifies PDF document manipulation tasks, making it a valuable tool for .NET developers working with PDF files.

FAQ’s

Q: What is a free text annotation in a PDF document?

A: A free text annotation in a PDF document is a type of annotation that allows you to add text to the document without being tied to a specific location or structure. It is commonly used to provide comments, notes, or other additional information in the document.

Q: Can I customize the appearance of the free text annotation using Aspose.PDF for .NET?

A: Yes, you can customize various properties of the free text annotation, such as the font, font size, color, position, and more.

Q: How do I specify the contents of the free text annotation?

A: To specify the contents of the free text annotation, you can set the Contents property of the FreeTextAnnotation object to the desired text.

Q: Can I add multiple free text annotations to a PDF document using Aspose.PDF for .NET?

A: Yes, you can create multiple free text annotations in a PDF document by creating multiple instances of the FreeTextAnnotation object and adding them to different pages or locations in the document.

Set Callout Property In PDF File Strike Out Words