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

导入jar文件

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

com.e-iceblue

e-iceblue

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

e-iceblue

spire.pdf.free

2.2.2

如果不是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);

}

}

生成文档：