创建 AcroForm - 在 Java 中创建可填写的 PDF

Aspose.PDF for Java 让您能够从头创建各种 AcroForm 字段类型。

创建一个文本框字段

在需要向新 PDF 表单添加单行文本输入字段时使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个带有目标矩形的 TextBoxField,并配置其外观。
  3. 将字段添加到表单并保存文档。
public static void addTextBoxField(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        Rectangle rectangle = new Rectangle(10, 600, 110, 620, true);
        TextBoxField textBoxField = new TextBoxField(page, rectangle);
        textBoxField.setPartialName("textbox1");
        textBoxField.setValue("Text Box");
        textBoxField.setDefaultAppearance(new DefaultAppearance("Arial", 10, Color.getDarkBlue().toRgb()));

        Border border = new Border(textBoxField);
        border.setWidth(1);
        border.setStyle(BorderStyle.Dashed);
        border.setDash(new Dash(3, 3));
        textBoxField.setBorder(border);

        textBoxField.getCharacteristics().setBorder(Color.getRed());
        textBoxField.getCharacteristics().setBackground(Color.getYellow().toRgb());

        document.getForm().add(textBoxField, 1);
        document.save(outputFile.toString());
    }
}

创建一个带有多个小部件的文本框字段

当同一文本字段值应出现在页面的多个位置时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 为字段小部件定义多个矩形和外观。
  3. 创建 TextBoxField, 配置每个小部件,并保存文档。
public static void addTextBoxFieldNt(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        Rectangle[] rects = {
                new Rectangle(10, 600, 110, 620, true),
                new Rectangle(10, 630, 110, 650, true),
                new Rectangle(10, 660, 110, 680, true)
        };

        DefaultAppearance[] defaultAppearances = {
                new DefaultAppearance("Arial", 10, Color.getDarkBlue().toRgb()),
                new DefaultAppearance("Helvetica", 12, Color.getDarkGreen().toRgb()),
                new DefaultAppearance(FontRepository.findFont("Calibri"), 14, Color.getDarkMagenta().toRgb())
        };

        TextBoxField textBoxField = new TextBoxField(page, rects);
        textBoxField.setPartialName("textbox1");
        textBoxField.setValue("Some text");

        int index = 0;
        for (WidgetAnnotation widget : textBoxField) {
            widget.setDefaultAppearance(defaultAppearances[index]);
            index++;
        }

        Border border = new Border(textBoxField);
        border.setWidth(1);
        border.setStyle(BorderStyle.Dashed);
        border.setDash(new Dash(3, 3));
        textBoxField.setBorder(border);

        textBoxField.getCharacteristics().setBorder(Color.getRed());
        textBoxField.getCharacteristics().setBackground(Color.getYellow().toRgb());

        document.getForm().add(textBoxField);
        document.save(outputFile.toString());
    }
}

创建单选按钮字段

当表单应让用户从预定义集合中选择一个选项时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个 RadioButtonField 并添加所需的选项。
  3. 将字段添加到表单并保存 PDF。
public static void addRadioButton(Path outputFile) {
    try (Document document = new Document()) {
        document.getPages().add();

        RadioButtonField radio = new RadioButtonField(document.getPages().get_Item(1));
        radio.addOption("Option 1", new Rectangle(100, 640, 120, 680, true));
        radio.addOption("Option 2", new Rectangle(140, 640, 160, 680, true));

        document.getForm().add(radio);
        document.save(outputFile.toString());
    }
}

创建组合框字段

当用户应从下拉列表中选择一个值时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个 ComboBoxField 并添加其可选择的选项。
  3. 设置默认选择并保存文档。
public static void addComboBox(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        ComboBoxField combo = new ComboBoxField(page, new Rectangle(100, 640, 150, 656, true));
        combo.addOption("Red");
        combo.addOption("Yellow");
        combo.addOption("Green");
        combo.addOption("Blue");
        combo.setSelected(3);

        document.getForm().add(combo);
        document.save(outputFile.toString());
    }
}

创建复选框字段

在表单需要真/假选项(例如同意或功能选择)时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个 CheckboxField 并配置其外观。
  3. 在表单中添加复选框并保存输出文件。
public static void addCheckboxFieldToPdf(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        CheckboxField checkbox = new CheckboxField(page, new Rectangle(50, 620, 100, 650, true));
        checkbox.getCharacteristics().setBackground(Color.getAqua().toRgb());
        checkbox.setStyle(BoxStyle.Circle);

        document.getForm().add(checkbox);
        document.save(outputFile.toString());
    }
}

创建列表框字段

当表单应在可见列表中显示多个可用选项时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个 ListBoxField 并添加可用的选项。
  3. 将字段添加到表单并保存文档。
public static void addListBoxFieldToPdf(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        ListBoxField listBox = new ListBoxField(page, new Rectangle(50, 650, 100, 700, true));
        listBox.setPartialName("list");
        listBox.addOption("Red");
        listBox.addOption("Green");
        listBox.addOption("Blue");

        document.getForm().add(listBox);
        document.save(outputFile.toString());
    }
}

创建签名字段

当文档需要为数字签名预留可见区域时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个 SignatureField 在所需的矩形中。
  3. 将字段添加到表单并保存输出 PDF。
public static void addSignatureField(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        SignatureField signatureField = new SignatureField(page, new Rectangle(100, 700, 200, 800, true));
        signatureField.setPartialName("Signature1");
        document.getForm().add(signatureField);
        document.save(outputFile.toString());
    }
}

创建条形码字段

当表单应在条形码字段中显示机器可读数据时,请使用此示例。

  1. 创建一个新的 PDF Document 并添加一页。
  2. 创建一个 BarcodeField 并添加条形码值。
  3. 将字段添加到表单并保存文档。
public static void addBarcodeField(Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();

        BarcodeField barcode = new BarcodeField(page, new Rectangle(100, 700, 200, 740, true));
        barcode.setPartialName("Barcode1");
        barcode.addBarcode("1234567890");
        document.getForm().add(barcode);
        document.save(outputFile.toString());
    }
}