使用C# 创建、填写、删除PDF表单域
通常情况下，PDF文件是不可编辑的，但PDF表单提供了一些可编辑区域，允许用户填写和提交信息。PDF表单通常用于收集信息、反馈或进行在线申请，是许多行业中数据收集和交换的重要工具。
PDF表单可以包含各种类型的输入控件，如文本框、复选框、下拉菜单、单选按钮等。本文将介绍如何使用C# 和一个免费.NET库来操作PDF表单，包括以下三个示例：
- 创建PDF表单域
- 填写PDF表单域
- 删除PDF表单域
安装免费.NET PDF库： Free Spire.PDF for .NET （可通过 NuGet安装，或下载后手动引用dll）
PM> Install-Package FreeSpire.PDF
常见PDF表单域
Free Spire.PDF for .NET 支持创建、操作多种PDF表域，包括文本框、复选框、组合框、列表框和单选按钮等。下表列出了一些常见的域及其在该免费库中对应的类名。
| 表单域名 | 类名 |
| 文本域 | PdfTextBoxField |
| 复选框 | PdfCheckBoxField |
| 组合框 | PdfComboBoxField |
| 列表框 | PdfListBoxField |
| 单选按钮 | PdfRadioButtonListField |
| 普通按钮 | PdfButtonField |
| 签名域 | PdfSignatureField |
使用C# 创建PDF表单域
使用Free Spire.PDF制作表单域，需要先创建以上各表单域类的对象，然后通过 Bounds 属性设置表单域的位置和大小，最后再通过PdfFormFieldCollection.Add() 方法将表单域绘制到PDF页面指定位置处。
以下是如何在PDF中创建上述常见PDF表单域的C#代码：
using Spire.Pdf; using Spire.Pdf.Actions; using Spire.Pdf.Fields; using Spire.Pdf.Graphics; using System.Drawing; namespace CreateFillableFormsInPdf { class Program { static void Main(string[] args) { //创建PdfDocument对象 PdfDocument pdf = new PdfDocument(); //添加一页 PdfPageBase page = pdf.Pages.Add(); //初始化x、y坐标 float baseX = 60; float baseY = 20; //创建两个画刷 PdfSolidBrush brush1 = new PdfSolidBrush(new PdfRGBColor(Color.Brown)); PdfSolidBrush brush2 = new PdfSolidBrush(new PdfRGBColor(Color.Black)); //创建字体 PdfTrueTypeFont font = new PdfTrueTypeFont(new Font("微软雅黑", 11f, FontStyle.Regular), true); //添加文本框 page.Canvas.DrawString("姓名:", font, brush1, new PointF(10, baseY)); RectangleF tbxBounds = new RectangleF(baseX, baseY, 150, 18); PdfTextBoxField textBox = new PdfTextBoxField(page, "姓名"); textBox.Bounds = tbxBounds; textBox.Font = font; pdf.Form.Fields.Add(textBox); baseY += 30; //添加两个复选框 page.Canvas.DrawString("民族:", font, brush1, new PointF(10, baseY)); RectangleF checkboxBound1 = new RectangleF(baseX, baseY, 15, 15); PdfCheckBoxField checkBoxField1 = new PdfCheckBoxField(page, "选项1"); checkBoxField1.Bounds = checkboxBound1; checkBoxField1.Checked = false; page.Canvas.DrawString("汉族", font, brush2, new PointF(baseX + 20, baseY)); RectangleF checkboxBound2 = new RectangleF(baseX + 70, baseY, 15, 15); PdfCheckBoxField checkBoxField2 = new PdfCheckBoxField(page, "选项2"); checkBoxField2.Bounds = checkboxBound2; checkBoxField2.Checked = false; page.Canvas.DrawString("少数民族", font, brush2, new PointF(baseX + 90, baseY)); pdf.Form.Fields.Add(checkBoxField1); pdf.Form.Fields.Add(checkBoxField2); baseY += 30; //添加列表框 page.Canvas.DrawString("分公司:", font, brush1, new PointF(10, baseY)); RectangleF listboxBound = new RectangleF(baseX, baseY, 150, 50); PdfListBoxField listBoxField = new PdfListBoxField(page, "分公司"); listBoxField.Items.Add(new PdfListFieldItem("成都", "成都")); listBoxField.Items.Add(new PdfListFieldItem("武汉", "武汉")); listBoxField.Items.Add(new PdfListFieldItem("深圳", "深圳")); ; listBoxField.Bounds = listboxBound; listBoxField.Font = font; pdf.Form.Fields.Add(listBoxField); baseY += 60; //添加两个单选按钮 page.Canvas.DrawString("性别:", font, brush1, new PointF(10, baseY)); PdfRadioButtonListField radioButtonListField = new PdfRadioButtonListField(page, "性别"); PdfRadioButtonListItem radioItem1 = new PdfRadioButtonListItem("选项1"); RectangleF radioBound1 = new RectangleF(baseX, baseY, 15, 15); radioItem1.Bounds = radioBound1; page.Canvas.DrawString("男", font, brush2, new PointF(baseX + 20, baseY)); PdfRadioButtonListItem radioItem2 = new PdfRadioButtonListItem("选项2"); RectangleF radioBound2 = new RectangleF(baseX + 70, baseY, 15, 15); radioItem2.Bounds = radioBound2; page.Canvas.DrawString("女", font, brush2, new PointF(baseX + 90, baseY)); radioButtonListField.Items.Add(radioItem1); radioButtonListField.Items.Add(radioItem2); pdf.Form.Fields.Add(radioButtonListField); baseY += 30; //添加组合框 page.Canvas.DrawString("部门:", font, brush1, new PointF(10, baseY)); RectangleF cmbBounds = new RectangleF(baseX, baseY, 150, 18); PdfComboBoxField comboBoxField = new PdfComboBoxField(page, "部门"); comboBoxField.Bounds = cmbBounds; comboBoxField.Items.Add(new PdfListFieldItem("财务", "财务")); comboBoxField.Items.Add(new PdfListFieldItem("技术", "技术")); comboBoxField.Items.Add(new PdfListFieldItem("采购", "采购")); comboBoxField.Items.Add(new PdfListFieldItem("销售", "销售")); comboBoxField.Font = font; pdf.Form.Fields.Add(comboBoxField); baseY += 30; //添加签名域 page.Canvas.DrawString("签名:", font, brush1, new PointF(10, baseY)); PdfSignatureField sgnField = new PdfSignatureField(page, "签名域"); RectangleF sgnBounds = new RectangleF(baseX, baseY, 150, 80); sgnField.Bounds = sgnBounds; pdf.Form.Fields.Add(sgnField); baseY += 90; //添加按钮 page.Canvas.DrawString("按钮:", font, brush1, new PointF(10, baseY)); RectangleF btnBounds = new RectangleF(baseX, baseY, 50, 18); PdfButtonField buttonField = new PdfButtonField(page, "按钮"); buttonField.Bounds = btnBounds; buttonField.Text = "提交"; buttonField.Font = font; PdfSubmitAction submitAction = new PdfSubmitAction("https://www.****.com"); submitAction.DataFormat = SubmitDataFormat.Html; buttonField.Actions.MouseDown = submitAction; pdf.Form.Fields.Add(buttonField); //保存文件 pdf.SaveToFile("PDF表单.pdf", FileFormat.PDF); } } }
生成文件：
使用C# 填写PDF表单域
填充表单域需要先获取PDF中的所有表单字段，然后确定其表单类型，最后再填写数据或从预定列表中选择值。
以下是如何填充现有PDF表单域的C#代码：
using Spire.Pdf; using Spire.Pdf.Fields; using Spire.Pdf.Widget; namespace FillFormFields { class Program { static void Main(string[] args) { //加载PDF表单 PdfDocument pdf = new PdfDocument(); pdf.LoadFromFile("PDF表单.pdf"); //获取文档中的表单 PdfFormWidget form = (PdfFormWidget)pdf.Form; //获取表单域集合 PdfFormFieldWidgetCollection formWidgetCollection = form.FieldsWidget; //遍历表单域 for (int i = 0; i < formWidgetCollection.Count; i++) { //获取指定域 PdfField field = formWidgetCollection[i]; //判断该表单域是否为文本框 if (field is PdfTextBoxFieldWidget) { if (field.Name == "姓名") { //填充文本 PdfTextBoxFieldWidget textBoxField = (PdfTextBoxFieldWidget)field; textBoxField.Text = "张三"; } } //判断该表单域是否为单选按钮 if (field is PdfRadioButtonListFieldWidget) { if (field.Name == "性别") { //为单选按钮选定一个值 PdfRadioButtonListFieldWidget radioButtonListField = (PdfRadioButtonListFieldWidget)field; radioButtonListField.SelectedIndex = 0; } } //判断该表单域是否为组合框 if (field is PdfComboBoxWidgetFieldWidget) { if (field.Name == "部门") { //为组合框选定一个值 PdfComboBoxWidgetFieldWidget comboBoxField = (PdfComboBoxWidgetFieldWidget)field; int[] index = { 1 }; comboBoxField.SelectedIndex = index; } } //判断该表单域是否为复选框 if (field is PdfCheckBoxWidgetFieldWidget) { //设置复选框的"已选中"状态 PdfCheckBoxWidgetFieldWidget checkBoxField = (PdfCheckBoxWidgetFieldWidget)field; switch (checkBoxField.Name) { case "选项1": checkBoxField.Checked = true; break; } } //判断该表单域是否为列表框 if (field is PdfListBoxWidgetFieldWidget) { if (field.Name == "分公司") { //为列表框选定一个值 PdfListBoxWidgetFieldWidget listBox = (PdfListBoxWidgetFieldWidget)field; int[] index = { 1 }; listBox.SelectedIndex = index; } } } //保存文件 pdf.SaveToFile("填充PDF表单域.pdf", FileFormat.PDF); } } }
输出结果：
使用C# 删除PDF表单域
Free Spire.PDF支持通过索引或名称删除指定的表单域或删除所有表单域。
以下是如何删除PDF表单域的C#代码：
using Spire.Pdf; using Spire.Pdf.Fields; using Spire.Pdf.Widget; namespace RemoveFormFields { class Program { static void Main(string[] args) { //加载PDF表单 PdfDocument pdf = new PdfDocument(); pdf.LoadFromFile("PDF表单.pdf"); //获取文档中的表单域 PdfFormWidget formWidget = pdf.Form as PdfFormWidget; //遍历表单域 for (int i = formWidget.FieldsWidget.List.Count - 1; i >= 0; i--) { //获取指定表单域 PdfField field = formWidget.FieldsWidget.List[i] as PdfField; //删除表单域 formWidget.FieldsWidget.Remove(field); } //通过表单域名获取指定表单 //PdfField field = formWidget.FieldsWidget["name"]; //删除该表单域 //formWidget.FieldsWidget.Remove(field); //保存PDF文件 pdf.SaveToFile("删除PDF表单域.pdf"); } } }
以上代码演示了PDF表单的基本操作，包括添加文本框、复选框、组合框、单选按钮等各种常见的表单域，填写现有PDF表单，以及删除PDF表单。Free Spire.PDF免费库该支持其他多种PDF元素，点击查看更多示例。
