C# 在PDF中添加墨迹注释Ink Annotation

悠悠 2023-10-11 17:04 7阅读 0赞

PDF中的墨迹注释（Ink Annotation），表现为徒手涂鸦式的形状；该类型的注释，可任意指定形状顶点的位置及个数，通过指定的顶点，程序将连接各点绘制成平滑的曲线。下面，通过C\#程序代码介绍如何在PDF中添加该注释。

## **一、dll****引用** ##

步骤1：在Visual Studio中打开“解决方案资源管理器”- 鼠标右键点击“引用”-“管理NuGet包”。

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_10_color_FFFFFF_t_70_g_se_x_16][]

步骤2：选择“浏览”-在搜索框中输入搜索内容，选择搜索结果，点击“安装”。

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_20_color_FFFFFF_t_70_g_se_x_16][]

步骤3：依次点击“OK”-"接受"，然后等待程序完成安装。

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_17_color_FFFFFF_t_70_g_se_x_16][]

或者，通过官方渠道，下载包[**Spire.PDF for .NET**][Spire.PDF for .NET] 到本地。解压后，将BIN文件夹下的Spire.Pdf.dll文件引用至VS程序。

## 二、代码示例 ##

添加注释时，除了自定义各个点的位置及数量，也可以设置墨迹颜色、线条宽度、透明度、注释的内容、名称等。下面是代码实现的步骤：

*  创建***PdfDocument***类的对象，并通过***PdfDocument.LoadFromFile(String fileName)***方法加载PDF文档。
 *  通过***PdfDocument.Pages\[int Index\]***属性获取PDF指定页面。
 *  创建类型为int的对象集合，集合元素为各墨迹顶点。
 *  创建PdfInkAnnotation类的实例。并通过该类提供的属性设置墨迹颜色、宽度、注释内容等格式。
 *  调用***PdfPageBase.AnnotationsWidget***属性提供的***PdfAnnotationCollection.Add(PdfAnnotation annotation)***方法添加注释到PDF。
 *  最后，通过***PdfDocument.SaveToFile(string filename, FileFormat fileFormat)***方法保存PDF文档到指定路径。

**C\#**

using Spire.Pdf;
    using Spire.Pdf.Annotations;
    using System.Collections.Generic;
    using System.Drawing;
    
    namespace InkAnnotation
    {
        class Program
        {
            static void Main(string[] args)
            {
                //加载PDF文档
                PdfDocument pdf = new PdfDocument();
                pdf.LoadFromFile("test.pdf");
    
                //获取第一页
                PdfPageBase pdfPage = pdf.Pages[0];
    
                //设置墨迹坐标点位置
                List<int[]> inkList = new List<int[]>();           
                int[] intPoints = new int[]
                {
                    370,700,
                    120,720,
                    110,760,
                    220,800,
                    270,790,
                    350,770,
                    350,670
                };
                inkList.Add(intPoints);
                //添加墨迹注释到PDF页面
                PdfInkAnnotation inkannotation = new PdfInkAnnotation(inkList);
                inkannotation.Color = Color.MediumVioletRed;
                inkannotation.Border.Width = 6;
                inkannotation.Opacity = 0.5f;
                inkannotation.Text = "This is an ink annotation. ";
                inkannotation.Name = "Manager";     
                pdfPage.AnnotationsWidget.Add(inkannotation);
    
                //保存文档
                Pdf.SaveToFile("AddInkAnnotation.pdf",FileFormat.PDF);
                System.Diagnostics.Process.Start("AddInkAnnotation.pdf");
            }
        }
    }

vb.net

Imports Spire.Pdf
    Imports Spire.Pdf.Annotations
    Imports System.Collections.Generic
    Imports System.Drawing
    
    Namespace InkAnnotation
    	Class Program
    		Private Shared Sub Main(args As String())
    			'加载PDF文档
    			Dim pdf As New PdfDocument()
    			pdf.LoadFromFile("test.pdf")
    
    			'获取第一页
    			Dim pdfPage As PdfPageBase = pdf.Pages(0)
    
    			'设置墨迹坐标点位置
    			Dim inkList As New List(Of Integer())()
    			Dim intPoints As Integer() = New Integer() {370, 700, 120, 720, 110, 760, _
    				220, 800, 270, 790, 350, 770, _
    				350, 670}
    			inkList.Add(intPoints)
    			'添加墨迹注释到PDF页面
    			Dim inkannotation As New PdfInkAnnotation(inkList)
    			inkannotation.Color = Color.MediumVioletRed
    			inkannotation.Border.Width = 6
    			inkannotation.Opacity = 0.5F
    			inkannotation.Text = "This is an ink annotation. "
    			inkannotation.Name = "Manager"
    			pdfPage.AnnotationsWidget.Add(inkannotation)
    
    			'保存文档
    			pdf.SaveToFile("AddInkAnnotation.pdf", FileFormat.PDF)
    		End Sub
    	End Class
    End Namespace

注释效果：

![watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_20_color_FFFFFF_t_70_g_se_x_16 1][]

—End—

[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_10_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/786fc8230efb438683fd2f2a72284663.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBARWljZWJsdWU=,size_10,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_20_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/ebfa97569178420ab5cb0117ef4b616c.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBARWljZWJsdWU=,size_20,color_FFFFFF,t_70,g_se,x_16
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_17_color_FFFFFF_t_70_g_se_x_16]: https://img-blog.csdnimg.cn/304df6b4b0b7447c87b5dd43823b3bcf.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBARWljZWJsdWU=,size_17,color_FFFFFF,t_70,g_se,x_16
[Spire.PDF for .NET]: https://www.e-iceblue.cn/Downloads/Spire-PDF-NET.html
[watermark_type_d3F5LXplbmhlaQ_shadow_50_text_Q1NETiBARWljZWJsdWU_size_20_color_FFFFFF_t_70_g_se_x_16 1]: https://img-blog.csdnimg.cn/15323b8005244155813434cf6dac79db.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBARWljZWJsdWU=,size_20,color_FFFFFF,t_70,g_se,x_16