创建表单域

创建文本域

文本域允许用户在指定区域输入文本，常用于收集用户信息或填写表格。

创建文本域的步骤如下：

从 CPDFDocument 上获取到需要创建文本域的页面对象。
在页面对象上创建文本域。
设置文本域的位置和其它属性。

以下是创建文本域的示例代码：

Java

CPDFDocument document = new CPDFDocument();
document.open(pdfPath);
int pageNumber = 0;
CPDFPage page = document.pageAtIndex(pageNumber);
RectF pageSize = document.getPageSize(pageNumber);
RectF singleLineTextRect = new RectF(28, 32, 237, 75);
//Insert a single-line TextField.
CPDFTextWidget textField = (CPDFTextWidget) page.addFormWidget(CPDFWidget.WidgetType.Widget_TextField,document);
textField.setRect(singleLineTextRect);
textField.setFieldName("TextField1");
textField.setText("Basic Text Field");
textField.setFontColor(Color.BLACK.getRGB());
textField.setFontSize(15);
textField.setFillColor(Color.RED.getRGB());
textField.setBorderColor(Color.YELLOW.getRGB());
textField.setBorderWidth(5F);
textField.updateAp();

创建按钮

按钮允许用户在 PDF 页面上执行操作，如页面跳转和超链接跳转。

创建按钮的步骤如下：

从 CPDFDocument 中获取页面对象。
在页面对象上创建按钮。
设置按钮位置，外观属性。
创建并设置按钮的文本属性。
创建并设置按钮的行为。
更新按钮外观。

以下是创建按钮的示例代码：

java

CPDFDocument document = CPDFDocument();
document.open(pdfPath);
RectF pageSize = document.getPageSize(0);
CPDFPage cpdfPage = document.pageAtIndex(0);

//创建按钮用于跳转到第二页
RectF pushButton1Rect = new RectF(267F, 203F, 401F, 235F);
CPDFPushbuttonWidget pushButtonWidget1 = (CPDFPushbuttonWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_PushButton,document);
pushButtonWidget1.setRect(pushButton1Rect);
pushButtonWidget1.setFieldName("PushButton1");
pushButtonWidget1.setFontColor(Color.BLACK.getRGB());
pushButtonWidget1.setFontSize(15);
pushButtonWidget1.setButtonTitle("PushButton");
CPDFGoToAction goToAction = new CPDFGoToAction();
CPDFDestination destination = new CPDFDestination(1, 0, 842, 0F);
goToAction.setDestination(document, destination);
pushButtonWidget1.setButtonAction(goToAction);
pushButtonWidget1.updateAp();

//创建按钮用于跳转到网页
RectF pushButton2Rect = new RectF(433F, 203F, 567F, 235F);
CPDFPushbuttonWidget pushButtonWidget2 = (CPDFPushbuttonWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_PushButton,document);
pushButtonWidget2.setRect(pushButton2Rect);
pushButtonWidget2.setFieldName("PushButton2");
pushButtonWidget2.setFontColor(Color.BLACK.getRGB());
pushButtonWidget2.setFontSize(15);
pushButtonWidget2.setButtonTitle("PushButton");
CPDFUriAction uriAction = new CPDFUriAction();
uriAction.setUri("https://www.compdf.com/");
pushButtonWidget2.setButtonAction(uriAction);
pushButtonWidget2.updateAp();

创建列表框

列表框允许用户从预定义的选项列表中选择一个或多个项目，提供便捷的数据选择功能。

创建列表框的步骤如下：

从 CPDFDocument 上获取到需要创建列表框的页面对象。
在页面对象上创建列表框。
设置列表框位置。
在列表框中添加列表项。
设置列表框属性。

以下是创建列表框的示例代码：

java

CPDFDocument document = new CPDFDocument();
document.open(pdfPath);
CPDFPage cpdfPage = document.pageAtIndex(0);
RectF pageSize = document.getPageSize(0);

RectF listBoxRect = new RectF(267F, 32F, 567F, 138F);
CPDFListboxWidget listBoxWidget = (CPDFListboxWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_ListBox,document);
listBoxWidget.setRect(listBoxRect);
listBoxWidget.setFieldName("ListBox1");
listBoxWidget.setFillColor(Color.WHITE.getRGB());
listBoxWidget.setBorderColor(Color.BLACK.getRGB());
listBoxWidget.setBorderWidth(2);
CPDFWidgetItem[] listBoxItems = new CPDFWidgetItem[]{
  new CPDFWidgetItem("List Box No.1", "List Box No.1"),
  new CPDFWidgetItem("List Box No.2", "List Box No.2"),
  new CPDFWidgetItem("List Box No.3", "List Box No.3"),
};
listBoxWidget.setOptionItems(listBoxItems);
listBoxWidget.setSelectedIndexes(new int[]{1});
listBoxWidget.updateAp();

创建签名域

签名域允许用户在文档中插入数字签名或电子签名，用于验证文档的真实性和完整性。

创建签名域的步骤如下：

从 CPDFDocument 上获取需要添加签名域的页面对象。
在页面对象上创建签名域。
设置签名域位置。
设置签名域属性。

以下是创建签名域的示例代码：

java

CPDFDocument document = new CPDFDocument();
document.open(pdfPath);
CPDFPage cpdfPage = document.pageAtIndex(0);
RectF pageSize = document.getPageSize(0);

RectF signatureRect = new RectF(28, 206, 237, 301);
CPDFSignatureWidget signatureWidget = (CPDFSignatureWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_SignatureFields,document);
signatureWidget.setFieldName("Signature1");
signatureWidget.setFillColor(Color.WHITE.getRGB());
signatureWidget.setBorderColor(Color.BLACK.getRGB());
signatureWidget.setBorderWidth(2F);
signatureWidget.setRect(signatureRect);
signatureWidget.updateAp();

创建复选框

复选框允许用户通过勾选或取消勾选来表示某个选项的状态。

创建复选框的步骤如下：

从 CPDFDocument 中获取需要添加复选框的页面对象。
在页面对象上创建复选框。
设置复选框位置。
设置复选框属性。

以下是创建复选框的示例代码：

java

CPDFDocument document = new CPDFDocument();
document.open(pdfPath);
CPDFPage cpdfPage = document.pageAtIndex(0);
RectF pageSize = document.getPageSize(0);

RectF checkBoxRect = new RectF(267, 251, 299, 283);
CPDFCheckboxWidget checkboxWidget = (CPDFCheckboxWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_CheckBox,document);
checkboxWidget.setRect(checkBox1);
checkboxWidget.setFieldName("CheckBox1");
checkboxWidget.setFillColor(Color.parseColor("#CCE5E5FF").getRGB());
checkboxWidget.setBorderColor(Color.BLACK.getRGB());
checkboxWidget.setBorderWidth(2F);
checkboxWidget.setChecked(false);
checkboxWidget.updateAp();

创建单选框

单选框允许用户在一组预定义选项中选择唯一的单个选项。

创建单选框的步骤如下：

从 CPDFDocument 中获取需要添加单选框的页面对象。
在页面对象上创建单选框。
设置单选框位置。
设置单选框属性。

以下是创建单选框的示例代码：

java

CPDFDocument document = new CPDFDocument();
document.open(pdfPath);
CPDFPage cpdfPage = document.pageAtIndex(0);
RectF pageSize = document.getPageSize(0);

RectF radioButtonRect = new RectF(385F, 251F, 424F, 290F);
CPDFRadiobuttonWidget radiobuttonWidget = (CPDFRadiobuttonWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_RadioButton,document);
radiobuttonWidget.setRect(radioButtonRect);
radiobuttonWidget.setFieldName("RadioButton");
radiobuttonWidget.setCheckStyle(CPDFWidget.CheckStyle.CK_Circle);
radiobuttonWidget.setFillColor(Color.decode("#CCE5E5FF").getRGB());
radiobuttonWidget.setBorderColor(Color.BLACK.getRGB());
radiobuttonWidget.setBorderWidth(2F);
radiobuttonWidget.setChecked(false);
radiobuttonWidget.setFieldName("RadioButton1");
radiobuttonWidget.updateAp();

创建下拉菜单

可以下拉的区域，选中下拉的一项将显示在该区域中。

创建下拉菜单的步骤如下：

从 CPDFDocument 中获取需要添加下拉菜单的页面对象。
在页面对象中创建下拉菜单。
在下拉菜单中添加列表项。
设置下拉菜单属性。

以下是创建下拉菜单的示例代码：

java

CPDFDocument document = new CPDFDocument();
document.open(pdfPath);
CPDFPage cpdfPage = document.pageAtIndex(0);
RectF pageSize = document.getPageSize(0);

RectF comboBoxRect = new RectF(267F, 143F, 567F, 189F);
CPDFComboboxWidget comboBoxWidget = (CPDFComboboxWidget) cpdfPage.addFormWidget(CPDFWidget.WidgetType.Widget_ComboBox,document);
comboBoxWidget.setRect(comboBoxRect);
comboBoxWidget.setFieldName("ComboBox1");
CPDFWidgetItem[] comboBoxItems = new CPDFWidgetItem[]{
  new CPDFWidgetItem("Combo Box No.1", "Combo Box No.1"),
  new CPDFWidgetItem("Combo Box No.2", "Combo Box No.2"),
  new CPDFWidgetItem("Combo Box No.3", "Combo Box No.3"),
};
comboBoxWidget.setOptionItems(comboBoxItems, new int[]{1});
comboBoxWidget.updateAp();

创建表单域 ​

创建表单域