Documentation – 修改 Form 字段

Python-Net: 添加列表项

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

PDF 中的列表框字段允许用户从预定义集合中选择一个或多个选项。使用 Aspose.PDF for Python，开发者可以以编程方式向这些字段添加新项目。The FormEditor 类提供了 ‘add_list_item’ 方法，用于向现有列表框字段追加项目。

打开现有的 PDF 表单。
创建一个 FormEditor 对象。
将 PDF 绑定到 FormEditor。
向列表框字段 “Country” 添加项目。
保存更新后的文档。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def add_list_item(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Add list item to list box field
    form_editor.add_list_item("Country", ["New Zealand", "New Zealand"])
    # Save updated document
    form_editor.save(outfile)

Python-Net: 复制内部字段

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

PDF 表单通常需要在保持原始格式和行为的同时复制字段。使用 Aspose.PDF for Python，开发者可以以编程方式将现有字段复制到同一页或其他页的新的位置。

本文阐述了如何将名为 ‘First Name’ 的字段复制为名为 ‘First Name Copy’ 的新字段，放置在第 2 页的特定坐标 (x=200, y=600)，生成一个包含新位置字段的 PDF。

打开现有的 PDF 表单。
创建一个 FormEditor 对象。
将 PDF 文档绑定到 FormEditor。
将 ‘First Name’ 字段复制到第 2 页坐标为 (200, 600) 的新字段 ‘First Name Copy’。
保存更新后的文档。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def copy_inner_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Copies an existing field to a new position specified by both page number and ordinates.
    # A new document will be produced, which contains everything the source document has except for the newly copied field.
    form_editor.copy_inner_field("First Name", "First Name Copy", 2, 200, 600)
    # Save updated document
    form_editor.save(outfile)

请注意：

‘copy_inner_field’ 方法签名如下：

copy_inner_field(original_field_name, new_field_name, page_number, x, y)

‘original_field_name’ — 您想要复制的字段。
’new_field_name’ – 新字段的名称。
‘page_number’ – 新字段将出现的页码。
x, y – 该页上的坐标。

page_number 应为正整数，对应于 PDF 中已存在的页（基于 1 的索引）。

如果传入负数参数，例如：

form_editor.copy_inner_field("First Name", "First Name Copy", -1, 200, 600)

程序将恢复到之前的参数。

Python-Net: 复制外部字段

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

有时，PDF 表单需要在文档之间复用字段。使用 Aspose.PDF for Python，开发者可以通过编程方式将表单字段从源 PDF 复制到目标 PDF。

这 FormEditor 类提供了 \u0027copy_outer_field\u0027 方法，该方法将在指定页面和坐标处将字段从源文档复制到目标文档。

代码创建一个新的 PDF（目标），添加一个页面，然后将现有 PDF（源）中的字段复制到目标文档的指定坐标处。

创建一个新的目标 PDF 文档。
至少向目标 PDF 添加一页。
保存空的目标文档。
创建一个 FormEditor 对象并将其绑定到目标 PDF。
将源 PDF 中的 ‘First Name’ 字段复制到第 1 页的坐标 (200, 600)。
保存更新后的目标 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def copy_outer_field(infile, outfile):
    # Since copy_outer_field() method needs to copy field from source document to target document, we need to create a new document as target document first.
    doc = ap.Document()
    doc.pages.add()
    doc.save(outfile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(outfile)
    # Copies an existing field to a new position specified by both page number and ordinates.
    # A new document will be produced, which contains everything the source document has except for the newly copied field.
    form_editor.copy_outer_field(infile, "First Name", 1, 200, 600)
    # Save updated document
    form_editor.save(outfile)

请注意：

‘copy_outer_field’ 方法签名如下：

copy_outer_field(original_field_name, new_field_name, page_number, x, y)

‘original_field_name’ — 您想要复制的字段。
’new_field_name’ – 新字段的名称。
‘page_number’ – 新字段将出现的页码。
x, y – 该页上的坐标。

page_number 应为正整数，对应于 PDF 中已存在的页（基于 1 的索引）。

如果传入负数参数，例如：

form_editor.copy_outer_field("First Name", "First Name Copy", 1, -200, 600)

程序将恢复到之前的参数。

Python-Net: 删除列表项

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

PDF 中的列表框字段允许用户选择一个或多个预定义选项。使用 Aspose.PDF for Python，开发人员可以以编程方式从这些字段中移除项目。

本文说明如何删除名为“Country”的列表框字段中的 ‘UK’ 项，确保该字段仅包含所需的选项。

这 FormEditor 该类提供 ‘del_list_item’ 方法，用于从列表框字段中移除特定项目。

打开现有的 PDF 表单。
创建一个 FormEditor 对象。
将 PDF 文档绑定到 FormEditor。
删除 “UK” 项从 “Country” 列表框字段。
保存更新后的文档。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def del_list_item(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Delete list item from list box field
    form_editor.del_list_item("Country", "UK")
    # Save updated document
    form_editor.save(outfile)

Python-Net: 移动字段

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

PDF 表单在创建后常常需要进行布局调整。使用 Aspose.PDF for Python，开发人员可以在不重新创建表单字段的情况下将其移动到新位置。

此示例展示了如何通过指定其在页面中的新坐标来重新定位 “Country” 字段。The FormEditor 类提供 move_field 方法以在 PDF 页面内重新定位字段。

打开现有的 PDF 表单。
创建一个 FormEditor 对象。
将 PDF 文档绑定到 FormEditor。
使用坐标将 ‘Country’ 字段移动到新位置。
保存修改后的文档。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def move_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Move field to new page
    form_editor.move_field("Country", 200, 600, 280, 620)
    # Save updated document
    form_editor.save(outfile)

Python-Net: 删除字段

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

由于设计更改或工作流更新，PDF 表单可能包含不再需要的字段。使用 Aspose.PDF for Python，开发人员可以轻松地以编程方式删除特定的表单字段。

这 FormEditor Aspose.PDF 中的类提供了 ‘remove_field’ 方法，允许开发人员按名称删除表单字段。

加载 PDF 文档。
创建一个 FormEditor 对象。
将 PDF 绑定到 FormEditor。
删除指定的表单字段。
保存更新后的文档。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def remove_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Remove field from document
    form_editor.remove_field("Country")
    # Save updated document
    form_editor.save(outfile)

Python-Net: 重命名字段

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

PDF 表单通常依赖字段名称进行脚本编写、自动化和数据处理。使用 Aspose.PDF for Python，开发人员可以在不重新创建字段或更改表单布局的情况下重命名现有字段。

这 FormEditor class 提供了 ‘rename_field’ 方法，允许开发人员在保留字段位置、值和外观的情况下更改现有字段的名称。

加载现有的 PDF 表单。
创建一个 FormEditor 实例。
将 PDF 文档绑定到编辑器。
重命名目标字段。
保存更新后的 PDF。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def rename_field(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Rename field in document
    form_editor.rename_field("City", "Town")
    # Save updated document
    form_editor.save(outfile)

Python-Net: 单行字段转换为多行字段

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

PDF 表单有时包含设计为单行输入的文本字段，这对于某些类型的数据可能不够。使用 Aspose.PDF for Python，开发人员可以轻松地将这些字段转换为多行文本字段，而无需重新创建它们。

使用 FormEditor 类，开发人员可以修改现有文本字段，而不会影响其位置或其他属性。

加载现有的 PDF 文档。
创建一个 FormEditor 实例。
将 PDF 文档绑定到编辑器。
将选定的字段转换为多行。
保存更新后的文档。

from io import FileIO
import sys
from os import path
import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

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

from config import set_license, initialize_data_dir


def single2multiple(infile, outfile):
    # Create FormEditor object
    form_editor = pdf_facades.FormEditor()
    # Bind document to FormEditor
    form_editor.bind_pdf(infile)
    # Change a single-lined text field to a multiple-lined one
    form_editor.single_2_multiple("City")
    # Save updated document
    form_editor.save(outfile)