使用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元素，點擊查看更多示例。