Documentation – 自定义字段外观

Python-Net: 装饰字段

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

PDF 表单通常需要视觉自定义，以提高可用性并创建一致的设计。使用 Aspose.PDF for Python，开发人员可以通过设置颜色、边框和文本对齐等属性，以编程方式装饰表单字段。

使用 FormEditor 和 FormFieldFacade 类开发人员可以轻松修改表单字段的外观，以提升可读性、突出必填字段或满足品牌需求。

打开现有的 PDF 文档。
创建一个 FormEditor 对象来操作表单字段。
使用 FormFieldFacade 定义视觉样式。
将样式应用于特定的表单字段。
保存更新后的文档。

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

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

from config import set_license, initialize_data_dir


def decorate_field(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)
    form_editor.facade = pdf_facades.FormFieldFacade()
    form_editor.facade.background_color = ap_pydrawing.Color.red
    form_editor.facade.text_color = ap_pydrawing.Color.blue
    form_editor.facade.border_color = ap_pydrawing.Color.green
    form_editor.facade.alignment = pdf_facades.FormFieldFacade.ALIGN_CENTER
    form_editor.decorate_field("First Name")

    # 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 对象。
检索特定字段的外观信息。

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

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

from config import set_license, initialize_data_dir


def get_field_appearance(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Get field appearance
    appearance = form_editor.get_field_appearance("Last Name")
    print("Field Appearance: " + str(appearance))

Python-Net: 设置字段对齐

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

PDF 表单字段常常需要自定义文本对齐以保持一致且专业的布局。使用 Aspose.PDF for Python，开发者可以以编程方式设置表单字段文本内容的对齐方式。

这 FormEditor 类，结合 FormFieldFacade constants，允许开发者以编程方式修改现有表单字段的对齐方式。

打开现有的 PDF 文档。
创建一个 FormEditor 对象。
将名为 “First Name” 的字段对齐方式设置为居中。
保存修改后的文档。

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

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

from config import set_license, initialize_data_dir


def set_field_alignment(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field alignment to center
    if form_editor.set_field_alignment(
        "First Name", pdf_facades.FormFieldFacade.ALIGN_CENTER
    ):
        # Save updated document
        form_editor.save(outfile)
    else:
        raise Exception(
            "Failed to set field alignment. Field may not support alignment."
        )

Python-Net: 设置字段垂直对齐

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

PDF 表单字段可能包含需要正确垂直对齐的文本，以实现一致且专业的外观。使用 Aspose.PDF for Python，开发人员可以以编程方式修改表单字段的垂直对齐。垂直对齐使开发人员能够控制字段文本是显示在字段边界框的顶部、居中还是底部，从而提升表单数据的布局和可读性。

使用 FormEditor 类和 FormFieldFacade 常量，开发人员可以以编程方式调整垂直对齐，以实现一致的表单布局：

打开现有的 PDF 文档。
创建一个 FormEditor 对象。
将名为 “First Name” 的字段的垂直对齐设置为底部。
保存修改后的文档。

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

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

from config import set_license, initialize_data_dir


def set_field_alignment_vertical(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Attempt to set vertical alignment of the "First Name" field to bottom
    if form_editor.set_field_alignment_v(
        "First Name", pdf_facades.FormFieldFacade.ALIGN_BOTTOM
    ):
        # Save updated document
        form_editor.save(outfile)
    else:
        raise Exception(
            "Failed to set field vertical alignment. Field may not support vertical alignment."
        )

Python-Net: 设置字段外观

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

PDF 表单字段支持控制可见性、可打印性和交互性的外观标志。使用 Aspose.PDF for Python，开发者可以以编程方式修改这些标志，以针对特定表单字段。

使用 FormEditor 开发者可以修改这些标志，以隐藏、显示或自定义交互式 PDF 中表单字段的行为。

打开现有的 PDF 文档。
创建一个 FormEditor 对象。
将字段名为“First Name”的外观设置为不可见。
保存更新后的文档。

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

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

from config import set_license, initialize_data_dir


def set_field_appearance(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field appearance to invisible
    if not form_editor.set_field_appearance(
        "First Name", ap.annotations.AnnotationFlags.INVISIBLE
    ):
        raise Exception(
            "Failed to set field appearance. Field may not support appearance flags."
        )

    # Save updated document
    form_editor.save(outfile)

Python-Net: 设置字段组合号码

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

组合号码定义了字段内容如何被拆分为等间距的盒子，常用于 PIN 码、序列号或其他固定长度的输入字段。代码打开现有 PDF，为字段设置组合号码，并保存修改后的文档。

这 FormEditor 该类提供了 ‘set_field_comb_number’ 方法，用于定义表单字段中盒子（字符）的数量。

打开现有的 PDF 表单。
创建一个 FormEditor 对象。
将名为 “PIN” 的字段的 comb number 设置为 5。
保存更新后的文档。

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

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

from config import set_license, initialize_data_dir


def set_field_comb_number(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field comb number to 5
    form_editor.set_field_comb_number("PIN", 5)

    # Save updated document
    form_editor.save(outfile)

Python-Net: 设置字段限制

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

PDF 文档中的表单字段可能需要输入限制以保持正确的格式。使用 Aspose.PDF for Python，开发者可以以编程方式为字段设置最大字符数。

这 FormEditor class 提供了 ‘set_field_limit’ 方法，用于为字段定义最大输入长度。

打开现有的 PDF 表单。
创建一个 FormEditor 对象。
为字段 “Last Name” 设置最大字符限制。
保存更新后的 PDF。

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

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

from config import set_license, initialize_data_dir


def set_field_limit(infile, outfile):
    # Open document
    doc = ap.Document(infile)

    # Create FormEditor object
    form_editor = pdf_facades.FormEditor(doc)

    # Set field limit to 10
    if not form_editor.set_field_limit("Last Name", 10):
        raise Exception(
            "Failed to set field limit. Field may not support specified limit."
        )

    # Save updated document
    form_editor.save(outfile)