Documentation – 创建表单字段

Python-Net: 创建复选框字段

Mon, 08 Jun 2026 00:00:00 +0000

PDF 表单广泛用于在申请、调查和协议等文档中收集用户输入。复选框字段让用户能够在表单中选择或取消选择一个选项。

使用 Aspose.PDF for Python，开发人员可以以编程方式操作 PDF 表单。 FormEditor 类提供用于在 PDF 文档中添加、编辑和管理表单字段的方法。

加载现有的 PDF 文件。
调用 ‘add_field()’ 方法并使用 ‘FieldType.CHECK_BOX’ 参数来创建复选框并指定其位置。
定义字段名称、标题和位置。
保存更新后的 PDF 文档。

import sys
from os import path
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_checkbox_field(infile, outfile):
    """Create CheckBox field in PDF document."""
    pdf_form_editor = pdf_facades.FormEditor()
    pdf_form_editor.bind_pdf(infile)

    # Add CheckBox field to PDF form
    pdf_form_editor.add_field(
        pdf_facades.FieldType.CHECK_BOX,
        "checkbox1",
        "Check Box 1",
        1,
        240,
        498,
        256,
        514,
    )

    # Save updated PDF document with form fields
    pdf_form_editor.save(outfile)

Python-Net: 创建 ComboBox 字段

Mon, 08 Jun 2026 00:00:00 +0000

PDF 表单广泛用于在数字文档（如申请表、调查问卷和注册表）中收集结构化信息。ComboBox 字段提供了一种方便的方式，让用户从预定义值列表中选择，同时保持表单紧凑有序。

这 FormEditor 该类允许您创建和管理不同类型的字段，包括文本框、复选框、单选按钮和下拉列表。

加载现有的 PDF 文档。
使用 ‘add_field()’ 方法和 ‘FieldType.COMBO_BOX’ 参数添加 ComboBox 字段。
使用 ‘add_list_item()’ 方法向下拉列表中插入可选择的选项。
保存更新后的 PDF 文档。

import sys
from os import path
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_combobox_field(infile, outfile):
    """Create ComboBox field in PDF document."""
    pdf_form_editor = pdf_facades.FormEditor()
    pdf_form_editor.bind_pdf(infile)

    # Add ComboBox field to PDF form
    pdf_form_editor.add_field(
        pdf_facades.FieldType.COMBO_BOX, "combobox1", "Australia", 1, 230, 498, 350, 514
    )
    pdf_form_editor.add_list_item("combobox1", ["Australia", "Australia"])
    pdf_form_editor.add_list_item("combobox1", ["New Zealand", "New Zealand"])

    # Save updated PDF document with form fields
    pdf_form_editor.save(outfile)

Python-Net: 创建 ListBox 字段

Mon, 08 Jun 2026 00:00:00 +0000

PDF 表单常用于申请表、调查问卷和注册文件。ListBox 字段可同时显示多个选项，便于用户浏览并从列表中选择项目。

这 FormEditor 类提供了添加不同类型交互字段的功能，包括 ListBox 元素。

加载现有的 PDF 文档。
定义一个可选择的选项列表。
向特定页面添加 ListBox 字段。
设置默认选定值。
保存更新后的 PDF 文档。

import sys
from os import path
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_listbox_field(infile, outfile):
    """Create ListBox field in PDF document."""
    pdf_form_editor = pdf_facades.FormEditor()
    pdf_form_editor.bind_pdf(infile)

    # Add ListBox field to PDF form
    pdf_form_editor.items = ["Australia", "New Zealand", "Malaysia"]
    pdf_form_editor.add_field(
        pdf_facades.FieldType.LIST_BOX, "listbox1", "Australia", 1, 230, 398, 350, 514
    )

    # Save updated PDF document with form fields
    pdf_form_editor.save(outfile)

Python-Net: 创建单选按钮字段

Mon, 08 Jun 2026 00:00:00 +0000

交互式 PDF 表单使用户能够直接在文档中提供结构化输入。当用户必须从多个选项中仅选择一个时，例如选择国家、性别或偏好，单选按钮字段非常有用。

这 FormEditor 类提供了创建不同类型字段的方法，包括文本框、复选框、组合框、列表框和单选按钮。

加载现有的 PDF 文档。
定义单选按钮选项列表。
在特定页面添加单选按钮字段。
设置默认选定值。
保存修改后的 PDF 文档。

import sys
from os import path
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_radiobutton_field(infile, outfile):
    """Create RadioButton field in PDF document."""
    pdf_form_editor = pdf_facades.FormEditor()
    pdf_form_editor.bind_pdf(infile)

    # Add RadioButton field to PDF form
    pdf_form_editor.items = ["Australia", "New Zealand", "Malaysia"]
    pdf_form_editor.add_field(
        pdf_facades.FieldType.RADIO, "radiobutton1", "Malaysia", 1, 240, 498, 256, 514
    )

    # Save updated PDF document with form fields
    pdf_form_editor.save(outfile)

Python-Net: 创建提交按钮

Mon, 08 Jun 2026 00:00:00 +0000

交互式 PDF 表单通常需要用户提交其输入以进行处理，例如发送调查结果、申请表或反馈数据。提交按钮字段通过将按钮链接到网络端点来提供此功能。

这 FormEditor 类允许添加按钮、复选框、单选按钮、文本字段和其他表单控件。

加载现有的 PDF 文档。
在特定页面添加一个提交按钮字段。
设置按钮标签和目标提交 URL。
保存包含新按钮的更新后 PDF。

import sys
from os import path
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_submit_button(infile, outfile):
    """Create Submit Button in PDF document."""
    pdf_form_editor = pdf_facades.FormEditor()
    pdf_form_editor.bind_pdf(infile)

    # Add Submit Button to PDF form
    pdf_form_editor.add_submit_btn(
        "submitbtn1",
        1,
        "Submit Button",
        "http://example.com/submit",
        100,
        450,
        200,
        470,
    )

    # Save updated PDF document with form fields
    pdf_form_editor.save(outfile)

Python-Net: 创建 TextBox 字段

Mon, 08 Jun 2026 00:00:00 +0000

PDF 表单通常需要用户输入文本，例如姓名、地址或评论。TextBox 字段通过在 PDF 文档中直接提供可编辑字段实现此功能。

这 FormEditor 该类允许添加文本字段、复选框、单选按钮、列表框、组合框和按钮，使构建交互式 PDF 变得简便。

加载现有的 PDF 文档。
添加多个 TextBox 字段供用户输入。
为每个字段设置默认值。
保存更新后的 PDF 文档。

import sys
from os import path
import aspose.pdf.facades as pdf_facades

sys.path.append(path.join(path.dirname(__file__), ".."))

from config import set_license, initialize_data_dir


def create_textbox_field(infile, outfile):
    """Create TextBox field in PDF document."""
    pdf_form_editor = pdf_facades.FormEditor()
    pdf_form_editor.bind_pdf(infile)

    # Add TextBox field to PDF form
    pdf_form_editor.add_field(
        pdf_facades.FieldType.TEXT, "first_name", "Alexander", 1, 50, 570, 150, 590
    )
    pdf_form_editor.add_field(
        pdf_facades.FieldType.TEXT, "last_name", "Smith", 1, 235, 570, 330, 590
    )

    # Save updated PDF document with form fields
    pdf_form_editor.save(outfile)