Java 创建PDF表单域 - 文本框、复选框、列表框、组合框、按钮等

表单域包括文本框、复选框、列表框、组合框、按钮和签名域等，主要用于收集用户填写或选择的数据。这篇文章将介绍如何在Java应用程序中给PDF文档添加表单域。

导入jar文件

本文所使用的PDF类库是Free Spire.PDF for Java, 如果你的项目是maven工程的话，在pom.xml文件中添加如下依赖，即可导入Free Spire.PDF for Java库jar文件。

<repositories>

        <repository>

            <id>com.e-iceblue</id>

            <name>e-iceblue</name>

            <url>http://repo.e-iceblue.com/nexus/content/groups/public/</url>

        </repository>

</repositories>

<dependencies>

    <dependency>

        <groupId>e-iceblue</groupId>

        <artifactId>spire.pdf.free</artifactId>

        <version>2.2.2</version>

    </dependency>

</dependencies>

如果不是maven，可通过官网下载最新的Free Spire.PDF for Java的jar文件（是一个压缩包，解压缩后在lib文件夹下可找到jar文件），然后将jar文件添加至程序中，下载地址。

实现代码

Free Spire.PDF for Java支持添加和操作多种PDF表单域，下表列出了一些常见的域及其在Free Spire.PDF for Java中对应的类名。

域名	类名
文本框	PdfTextBoxField
复选框	PdfCheckBoxField
列表框	PdfListBoxField
组合框	PdfComboBoxField
单选按钮	PdfRadioButtonListField
按钮	PdfButtonField
签名域	PdfSignatureField

 以下代码展示了如何给PDF文档添加文本框、复选框、列表框、组合框、单选按钮和按钮。签名域在之前的文章中已经写过了，此处不再介绍。

import java.awt.*;
import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;

import com.spire.pdf.FileFormat;
import com.spire.pdf.PdfDocument;
import com.spire.pdf.PdfPageBase;
import com.spire.pdf.fields.*;
import com.spire.pdf.graphics.*;


public class CreateFormFields {
    public static void main(String[] args) throws Exception {
        //创建PdfDocument对象
        PdfDocument doc = new PdfDocument();

        //添加页面
        PdfPageBase page = doc.getPages().add();

        //初始化位置变量
        float baseX = 100;
        float baseY = 50;

        //创建画刷对象
        PdfSolidBrush brush1 = new PdfSolidBrush(new PdfRGBColor(Color.BLUE));
        PdfSolidBrush brush2 = new PdfSolidBrush(new PdfRGBColor(Color.black));

        //创建TrueType字体
        PdfTrueTypeFont font= new PdfTrueTypeFont(new Font("Arial Unicode MS",Font.PLAIN,12),true);

        //添加文本框
        String text = "姓名:";//文本框前的文字
        page.getCanvas().drawString(text, font, brush1, new Point2D.Float(0, baseY));//在PDF中绘制文字
        Rectangle2D.Float tbxBounds = new Rectangle2D.Float(baseX, baseY , 150, 15);//创建Rectangle2D对象
        PdfTextBoxField textBox = new PdfTextBoxField(page, "TextBox");//创建文本框对象
        textBox.setBounds(tbxBounds);//设置文本框的Bounds,包括位置和大小信息
        textBox.setText("洋洋");//设置文本框的默认文字
        textBox.setFont(font);//设置文本框的字体
        doc.getForm().getFields().add(textBox);//添加文本框到PDF域的集合
        baseY +=25;

        //添加复选框
        page.getCanvas().drawString("民族:", font, brush1, new Point2D.Float(0, baseY));
        java.awt.geom.Rectangle2D.Float rec1 = new java.awt.geom.Rectangle2D.Float(baseX, baseY, 15, 15);
        PdfCheckBoxField checkBoxField = new PdfCheckBoxField(page, "CheckBox1");
        checkBoxField.setBounds(rec1);
        checkBoxField.setChecked(true);
        page.getCanvas().drawString("汉族", font, brush2, new Point2D.Float(baseX + 20, baseY));
        java.awt.geom.Rectangle2D.Float rec2 = new java.awt.geom.Rectangle2D.Float(baseX + 70, baseY, 15, 15);
        PdfCheckBoxField checkBoxField1 = new PdfCheckBoxField(page, "CheckBox2");
        checkBoxField1.setBounds(rec2);
        checkBoxField1.setChecked(false);
        page.getCanvas().drawString("少数民族", font,  brush2, new Point2D.Float(baseX+90, baseY));
        doc.getForm().getFields().add(checkBoxField);
        baseY += 25;

        //添加列表框
        page.getCanvas().drawString("年龄:", font, brush1, new Point2D.Float(0, baseY));
        java.awt.geom.Rectangle2D.Float rec = new java.awt.geom.Rectangle2D.Float(baseX, baseY, 150, 50);
        PdfListBoxField listBoxField = new PdfListBoxField(page, "ListBox");
        listBoxField.getItems().add(new PdfListFieldItem("3岁", "item1"));
        listBoxField.getItems().add(new PdfListFieldItem("4岁", "item2"));
        listBoxField.getItems().add(new PdfListFieldItem("5岁", "item3"));;
        listBoxField.setBounds(rec);
        listBoxField.setFont(font);
        listBoxField.setSelectedIndex(0);
        doc.getForm().getFields().add(listBoxField);
        baseY += 60;

        //添加单选按钮
        page.getCanvas().drawString("性别:", font, brush1, new Point2D.Float(0, baseY));
        PdfRadioButtonListField radioButtonListField = new PdfRadioButtonListField(page, "Radio");
        PdfRadioButtonListItem radioItem1 = new PdfRadioButtonListItem("Item1");
        radioItem1.setBounds(new Rectangle2D.Float(baseX, baseY, 15, 15));
        page.getCanvas().drawString("男", font, brush2, new Point2D.Float(baseX + 20, baseY));
        PdfRadioButtonListItem radioItem2 = new PdfRadioButtonListItem("Item2");
        radioItem2.setBounds(new Rectangle2D.Float(baseX + 70, baseY, 15, 15));
        page.getCanvas().drawString("女", font, brush2, new Point2D.Float(baseX + 90, baseY));
        radioButtonListField.getItems().add(radioItem1);
        radioButtonListField.getItems().add(radioItem2);
        radioButtonListField.setSelectedIndex(0);
        doc.getForm().getFields().add(radioButtonListField);
        baseY += 25;

        //添加组合框
        page.getCanvas().drawString("班级:", font, brush1, new Point2D.Float(0, baseY));
        Rectangle2D.Float cmbBounds = new Rectangle2D.Float(baseX, baseY, 150, 15);
        PdfComboBoxField comboBoxField = new PdfComboBoxField(page, "ComboBox");
        comboBoxField.setBounds(cmbBounds);
        comboBoxField.getItems().add(new PdfListFieldItem("幼儿园小班", "item1"));
        comboBoxField.getItems().add(new PdfListFieldItem("幼儿园中班", "itme2"));
        comboBoxField.getItems().add(new PdfListFieldItem("幼儿园大班", "item3"));
        comboBoxField.setSelectedIndex(0);
        comboBoxField.setFont(font);
        doc.getForm().getFields().add(comboBoxField);
        baseY += 25;

        //添加按钮
        page.getCanvas().drawString("提交按钮:", font, brush1, new Point2D.Float(0, baseY));
        Rectangle2D.Float btnBounds = new Rectangle2D.Float(baseX, baseY, 50, 15);
        PdfButtonField buttonField = new PdfButtonField(page, "Button");
        buttonField.setBounds(btnBounds);
        buttonField.setText("提交");
        buttonField.setFont(font);
        doc.getForm().getFields().add(buttonField);

        //保存文档
        doc.saveToFile("AddFormField.pdf", FileFormat.PDF);
    }
}

生成文档：