C# 如何给现有/新建PDF文档添加注释或标注

小灰灰 2024-02-17 18:39 63阅读 0赞

这篇文章主要介绍如何使用免费版PDF组件**Free Spire.PDF**及C\#编程语言给现有PDF文档或新建的PDF文档中的文本添加注释或标注（完整代码附在文章末尾）。

首先，下载 [Free Spire.PDF][] 组件并安装后，打开Visual Studio创建项目并引用Spire.Pdf.dll，如下图：

![Center][]

接下来添加命名空间：

using System.Drawing;
    using Spire.Pdf;
    using Spire.Pdf.Annotations;
    using Spire.Pdf.General.Find;
    using Spire.Pdf.Graphics;

命名空间添加后，我们就可以使用其中的类和方法来实现添加注释。

**给现有的PDF文档中的文本添加注释**

文档：

![Center 1][]

接下来的部分主要阐述如何给以上PDF文档中的文本**“唐朝”**添加注释。

**1.** 从系统加载PDF文档。

PdfDocument doc = new PdfDocument();
    doc.LoadFromFile("唐朝.pdf");

**2.** 声明一个**PdfTextFind**类型的数组并创建一个新的PDF字体。

PdfTextFind[] result = null;
    PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("Arial Unicode MS", 11f), true);

**3.** 获取文本，创建注释并添加到PDF页面。

遍历PDF文档的所有页面，获取需要添加注释的文本并将它们保存到声明的数组中，然后遍历数组，为每个文本创建注释并指定注释的作者、注释内容、注释的文本，位置，及字体等，然后设置注释的边框、颜色，最后将注释添加到页面上。

foreach (PdfPageBase page in doc.Pages)
    {
        result =page.FindText("唐朝").Finds;
        foreach (PdfTextFind text in result)
        {
           PdfTextMarkupAnnotation annotation = new PdfTextMarkupAnnotation("汤姆", "618年—907年", text.SearchText, text.Position, font);
           annotation.Border= new PdfAnnotationBorder(0.75f);
           annotation.TextMarkupColor= Color.Green; 
           text.SearchPage.AnnotationsWidget.Add(annotation);
        }
    }

**4.** 保存文档。

doc.SaveToFile("输出.pdf");

以上代码需要**注意**的几点：

1. 这里我是将文档放在项目的Debug目录下的。你也可以从路径加载文档，如：doc.LoadFromFile(@"E:\\Program Files\\唐朝.pdf");

2. Free Spire.PDF组件提供了几个不同的PDF字体类，因为这里我们使用的文档是中文，所以要选择支持中文的字体类，如**PdfTrueTypeFont**类和**PdfCjkStandardFont**类（支持繁体中文）。同时，在使用系统字体时也要注意选择支持中文（Unicode）的字体，如“Arial Unicode MS”。

3. 这里我遍历了PDF文档的所有页面，如果你只需要对某一页的文本添加注释，则只需获取该页，如：PdfPageBase page =doc.Pages\[0\];

运行结果：

![Center 2][]

**给新建的PDF文档添加注释**

给新建PDF文档添加注释较为简单，代码如下：

//创建文档
    PdfDocument doc1 = new PdfDocument();
    PdfPageBase page1 =doc1.Pages.Add();
    //向文档添加文本
    PdfFont font1 = new PdfFont(PdfFontFamily.Helvetica,13);
    string text1 = "HelloWorld";
    PointF point = new PointF(200, 100);
    page1.Canvas.DrawString(text1, font1, PdfBrushes.CadetBlue, point);
     
    //给文本创建注释
    PdfTextMarkupAnnotation annotation1 = new PdfTextMarkupAnnotation("管理员", "这是一个文本注释",text1, new PointF(0,0), font1);
    annotation1.Border = new PdfAnnotationBorder(0.75f);
    annotation1.TextMarkupColor = Color.Green;
    annotation1.Location = new PointF(point.X +doc1.PageSettings.Margins.Left, point.Y + doc1.PageSettings.Margins.Left);
    //将注释添加到页面
    (page1 as PdfNewPage).Annotations.Add(annotation1);
    //保存文档
    doc1.SaveToFile("新建.pdf");

运行结果：

![Center 3][]

**完整代码：**

using System.Drawing;
    using Spire.Pdf;
    using Spire.Pdf.Annotations;
    using Spire.Pdf.General.Find;
    using Spire.Pdf.Graphics;
     
    namespace PDF文档添加注释
    {
        class Program
        {
            static void Main(string[] args)
            {
                //给现有的PDF文档中的文本添加注释
                PdfDocument doc = new PdfDocument();
                doc.LoadFromFile("唐朝.pdf");
                PdfTextFind[] result = null;
                PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("Arial Unicode MS", 11f), true);
                foreach (PdfPageBasepage in doc.Pages)
                {
                   result = page.FindText("唐朝").Finds;
                   foreach (PdfTextFind text in result)
                   {
                       PdfTextMarkupAnnotation annotation = new PdfTextMarkupAnnotation("汤姆", "618年—907年",text.SearchText, text.Postition, font);
                       annotation.Border = new PdfAnnotationBorder(0.75f);
                       annotation.TextMarkupColor = Color.Green;
                       text.SearchPage.AnnotationsWidget.Add(annotation);
                   }
                }
                doc.SaveToFile("输出.pdf");
     
                //给新建的PDF文档添加注释
                PdfDocument doc1 = new PdfDocument();
                PdfPageBase page1 = doc1.Pages.Add();
                PdfFont font1 = new PdfFont(PdfFontFamily.Helvetica,13);
                string text1 = "HelloWorld";
                PointF point = new PointF(200, 100);
                page1.Canvas.DrawString(text1, font1, PdfBrushes.CadetBlue,point);
     
                PdfTextMarkupAnnotation annotation1 = new PdfTextMarkupAnnotation("管理员", "这是一个文本注释",text1, new PointF(0,0), font1);
                annotation1.Border = new PdfAnnotationBorder(0.75f);
                annotation1.TextMarkupColor = Color.Green;
     
                annotation1.Location = new PointF(point.X + doc1.PageSettings.Margins.Left,point.Y + doc1.PageSettings.Margins.Left);
                (page1 as PdfNewPage).Annotations.Add(annotation1);
     
                doc1.SaveToFile("新建.pdf");
            }
        }
    }

[Free Spire.PDF]: https://www.e-iceblue.com/Introduce/free-pdf-component.html
[Center]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/87480f2dd8774371a8f846751a79c77c.png
[Center 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/24098510c245403b917bdee16bba1ca7.png
[Center 2]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/8371746fbf904c4b9c30c0a6b6330b3e.png
[Center 3]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/29/c9c3bf806916438ab8dee931d32df17b.png