C# 在PDF中创建和填充域

本文主要介绍了C# 在PDF中创建和填充域的相关知识。具有很好的参考价值，下面跟着小编一起来看下吧

众所周知，pdf文档通常是不能编辑和修改的。如果用户需要在pdf文档中签名或者填写其他内容时，就需要pdf文档中有可编辑的域。开发者也经常会遇到将数据以编程的方式填充到pdf模板域的需求。这时候就需要解决以下两个问题：

如何在pdf中创建可编辑的域？
如何将内容准确地填写到这些域中？

这里我将介绍怎样使用c#和free spire.pdf组件来实现这一功能。

free spire.pdf组件概述

free spire.pdf是一个免费专业的pdf组件，用于在.net应用程序中创建，编辑，处理和阅读pdf文档。支持丰富的pdf文档处理操作，如pdf文档合并/拆分、转换（如html转pdf，pdf转图片等）、打印（包括静默打印）、压缩、添加注释、安全设置（包括数字签名）、创建与填充域、图片插入与提取、文本提取与高亮等。不依赖adobe acrobat，并且支持中文。

关于安装，有很多种渠道，包括官网以及开发者最喜欢和常用的nuget方式。在visual studio的 nuget package manager console中输入以下powershell命令回车，组件的dll就会自动地引用到项目中：

pm> install-package freespire.pdf

创建和填充域的实现

1．创建域

该组件提供了很多对应的类，通过这些类我们可以创建多种pdf域。因为种类比较多，所以下面我只列出了一些常见的域和该域在组件中所对应的类名。

域名	类名
文本域	pdftextboxfield
签名域	pdfsignaturefield
复选框	pdfcheckboxfield
组合框	pdfcomboboxfield
列表框	pdflistboxfield
按钮	pdfradiobuttonlistfield（单选按钮） pdfbuttonfield （普通按钮）

这里我选取pdf文档中最常见的两种可编辑域进行介绍：文本域和签名域。

1.1 文本域

首先，我创建了一个简单的文本域。在创建的时候需要指定域的名称，这样做的好处在于，如果文档中同时存在多个文本域，当我们以编程的方式填写域的时候，可以根据域的名称快速准确地将内容填写到指定的域中。需要注意的是域名不要重复，否则会将内容填写到该域名对应的所有域中。

				?

									//创建pdf文档

									pdfdocument pdf = new pdfdocument();

									//添加一个新页面

									pdfpagebase page = pdf.pages.add(pdfpagesize.a4, new pdfmargins());

									//添加文本到页面

									pdftruetypefont font = new pdftruetypefont(new font("arial unicode ms", 10f), true);

									page.canvas.drawstring("年龄:", font, pdfbrushes.deepskyblue, 10, 50);

									//创建文本域并指定文本域的名称

									pdftextboxfield textbox = new pdftextboxfield(page, "age");  

									//设置文本域的大小、位置、字体

									textbox.bounds = new rectanglef(40, 50, 50, 12);  

									textbox.font = font;

									//添加文本域到文档

									pdf.form.fields.add(textbox);

									//保存文档

									pdf.savetofile("fields.pdf");

C# 在PDF中创建和填充域

当然多数时候我们的需求可能不止是创建一个简单的文本域，还需要做一些其他设置，如设置边框、背景色、字体颜色、字体排列方式。甚至是指定文本域的输入内容，如只能输入日期或某一范围内的数字等。

设置格式：

				?

									//设置边框

									textbox.borderwidth = 0.75f;

									textbox.borderstyle = pdfborderstyle.solid;

									textbox.bordercolor = color.black;

									//设置背景色

									textbox.backcolor = color.yellow;

									//设置字体颜色

									textbox.forecolor = color.red;

									//设置字体排列方式 

									textbox.textalignment = pdftextalignment.center;

C# 在PDF中创建和填充域

指定文本域的输入内容：

adobe acrobat支持开发者使用javascript来预先定义文本域输入内容的格式、类型等。该组件也支持这类script并提供了对应的方法来实现这些功能。下表列出了部分javascript和方法：

描述	示例	javascript	方法
date	01/31/2008	afdate_formatex("mm/dd/yyyy"); afdate_keystrokeex("mm/dd/yyyy");	getdateformatstring("mm/dd/yyyy"); getdatekeystrokestring("mm/dd/yyyy");
date	1/31/2008	afdate_formatex("m/d/yyyy"); afdate_keystrokeex("m/d/yyyy");	getdateformatstring("m/d/yyyy"); getdatekeystrokestring("m/d/yyyy");
zip code	12345	afspecial_format(0); afspecial_keystroke(0);	getspecialformatstring(0); getspecialkeystrokestring(0);
zip+4	12345-1234	afspecial_format(1); afspecial_keystroke(1);	getspecialformatstring(1); getspecialkeystrokestring(1);
phone number	(123) 456-7890	afspecial_format(2); afspecial_keystroke(2);	getspecialformatstring(2); getspecialkeystrokestring(2);
money	$12,345.00 -$12,345.00	afnumber_format(2, 0, 0, 0, "$", true); afnumber_keystroke(2, 0, 0, 0, "$", true);	getnumberformatstring(2, 0, 0, 0, "$", true); getnumberkeystrokestring(2, 0, 0, 0, "$", true);
validate	1≤input value≤10	afrange_validate(true,1,true,10)	getrangevalidatestring(true, 1, true, 10);

示例：

				?

									//指定输入数据在1-100之间

									string js = pdfjavascript.getrangevalidatestring(true, 1, true, 100);

									pdfjavascriptaction jsaction = new pdfjavascriptaction(js);

									textbox.actions.validate = jsaction;

C# 在PDF中创建和填充域

1.2 签名域

创建签名域与文本域类似，也可以设置域的边框、大小、位置等属性。这里就不再赘述了。

				?

									//创建签名域并指定域名

									pdfsignaturefield signaturefield = new pdfsignaturefield(page, "signature");

									//设置域的边框

									signaturefield.borderwidth = 1.0f;

									signaturefield.borderstyle = pdfborderstyle.solid;

									signaturefield.bordercolor = new pdfrgbcolor(system.drawing.color.black);

									//设置高亮模式

									signaturefield.highlightmode = pdfhighlightmode.outline;

									//设置大小与位置

									signaturefield.bounds = new rectanglef(40, 150, 200, 100);

									//将签名域添加到页面

									pdf.form.fields.add(signaturefield);

C# 在PDF中创建和填充域

2. 填充域

填充域时需要先获取文档中所有的域，然后再逐一填充指定域。如果同一类型的域比较多，则可使用域的名称快速填充。

				?

									//加载pdf文档

									pdfdocument pdf = new pdfdocument();

									pdf.loadfromfile("fields.pdf");

									//获取第一页

									pdfpagebase page = pdf.pages[0];

									//获取文档的所有域

									pdfformwidget form = pdf.form as pdfformwidget;

									//填充第一个文本域

									pdftextboxfieldwidget textboxfield = form.fieldswidget[0] as pdftextboxfieldwidget;

									textboxfield.text = "25";

									//填充第二个签名域

									pdfsignaturefieldwidget signaturefield = form.fieldswidget[1] as pdfsignaturefieldwidget;

									string pfxpath = @"gary.pfx";

									pdfcertificate digi = new pdfcertificate(pfxpath, "123456");   

									pdfsignature signature = new pdfsignature(pdf, page, digi, "demo", signaturefield);

									signature.istag = true;

									signature.digitalsigner = "gary";

									signature.configgraphictype = configuergraphictype.textsigninformation;

									//保存文档

									pdf.savetofile("fill.pdf");