Documentation – 使用 PDF Facades

Python-Net: PdfFileEditor 类

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

处理 PDF 文档包括各种功能。管理 PDF 文件的页面是这项工作的重要部分。‘aspose.pdf.facades’ 提供了 PdfFileEditor 用于此目的的类。

PdfFileEditor 类包含用于操作单个页面的方法；该类不编辑或操作页面的内容。您可以插入新页面、删除现有页面、拆分页面，或使用 PdfFileEditor 指定页面的排版方式。

使用 PdfFileEditor 可以做什么

该类提供的功能可以分为页面编辑、PDF 排版和文档拆分工作流。本系列文章展示了如何重新排列页面、合并多个 PDF、为打印准备文件以及在不手动编辑源文件的情况下从现有文档中提取章节。

PdfFileEditor 教程

Python-Net: PdfContentEditor 类

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

这 PdfContentEditor Aspose.PDF Facades 中的类旨在对现有 PDF 文档进行内容级编辑任务。它提供了简化的 API，用于更新交互式元素、替换文本、处理附件和链接，以及在 Python via .NET 应用程序中调整文档行为。

使用 PdfContentEditor 可以做什么

使用此部分来探索 PDF 内容编辑支持的主要领域 PdfContentEditor 外观:

Python-Net: PdfAnnotationEditor 类

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

这 PdfAnnotationEditor Aspose.PDF Facades 中的类旨在处理 PDF 注释和基于评论的标记，而无需手动编辑文档的低层结构。它在 Python via .NET 环境下提供了一种简化的方式来处理注释工作流，适用于需要检查或更新现有 PDF 文件的情况。

PdfAnnotationEditor 的用途是什么

当您的 PDF 工作流涉及注释、审阅评论或其他需要以编程方式管理的标记元素时，请使用此外观。随着本节的扩展，它应该作为围绕该主题构建的注释相关教程的着陆页。 PdfAnnotationEditor 类。

Python-Net: PdfFileSignature 类

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

准备 PDF 数字签名助手

在对 PDF 应用数字签名之前，最佳实践是设置一组可重用的辅助函数。这些函数封装了常见任务——例如初始化签名处理程序、定义签名的可视位置以及配置基于证书的签名——从而使您的主要签名逻辑保持简洁、一致且易于维护。

此设置实现的目标

此辅助层准备了顺畅签名工作流所需的一切：

初始化 PdfFileSignature 对象并将其绑定到文档
定义签名在页面上的显示位置
加载并应用签名证书
创建带有元数据的可重用 PKCS#7 签名对象
自定义签名的视觉外观

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd


DEFAULT_CERTIFICATE_PASSWORD = "Aspose2021"
DEFAULT_SIGNATURE_NAME = "Signature1"


def create_pdf_file_signature(infile):
    pdf_signature = pdf_facades.PdfFileSignature()
    pdf_signature.bind_pdf(infile)
    return pdf_signature


def create_signature_rectangle():
    return apd.Rectangle(10, 10, 200, 60)


def configure_signature_certificate(
    pdf_signature, certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    pdf_signature.set_certificate(certificate_path, certificate_password)


def create_pkcs7_signature(
    certificate_path, certificate_password=DEFAULT_CERTIFICATE_PASSWORD
):
    signature = ap.forms.PKCS7(certificate_path, certificate_password)
    signature.reason = "Document approval"
    signature.contact_info = "qa@example.com"
    signature.location = "New York, USA"
    signature.authority = "Aspose.PDF Example"
    return signature


def create_custom_signature_appearance():
    appearance = ap.forms.SignatureCustomAppearance()
    appearance.font_family_name = "Arial"
    appearance.font_size = 10
    appearance.show_contact_info = True
    appearance.show_location = True
    appearance.show_reason = True
    return appearance

Python-Net: FormEditor 类

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

这 FormEditor Aspose.PDF Facades 中的类旨在创建和更新交互式 PDF 表单字段。它帮助您构建表单结构，调整字段属性，修改外观设置，并在 Python 应用程序中附加诸如脚本和提交操作等交互行为。

常见 FormEditor 任务

使用以下教程来使用主要功能 FormEditor 外观:

Python-Net: PdfFileInfo 类

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

这 PdfFileInfo Aspose.PDF Facades 中的 class 提供对文档级和页面级 PDF 信息的访问，而无需进行低层解析。它在需要检查元数据、检索文档属性、检查权限，或在自动化工作流中检查页面尺寸和偏移时非常有用。

使用 PdfFileInfo 可以做什么

使用本节中的文章来探索主要的文件检查功能 PdfFileInfo 外观:

Python-Net: PdfFileSecurity 类

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

这 PdfFileSecurity Aspose.PDF Facades 中的 class 用于保护 PDF 文档并控制用户对其的交互方式。它支持常见的安全工作流，如基于密码的加密、解密、密码轮换以及打印、复制和编辑的权限管理。

使用 PdfFileSecurity 可以做什么

使用本节中的文章来探索该部分支持的主要 PDF 安全任务 PdfFileSecurity 外观:

Python-Net: PdfViewer 类

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

Aspose.PDF for Python via .NET 提供了 PdfViewer 用于处理 PDF 查看和页面解码场景的外观。一个常见的用例是将 PDF 页面转换为图像对象，然后可以将其保存到磁盘。

创建可复用的 PdfViewer 辅助类

在解码页面或读取与查看器相关的属性之前，创建一个小的帮助程序来初始化并返回一个 PdfViewer 实例。这使下面的示例保持自包含，并清楚地说明在将查看器对象绑定到 PDF 文档之前，它是如何创建的。

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades


def _create_viewer() -> pdf_facades.PdfViewer:
    """Create a PdfViewer configured for decoding examples."""
    viewer = pdf_facades.PdfViewer()
    viewer.coordinate_type = ap.PageCoordinateType.MEDIA_BOX
    viewer.resolution = 150
    viewer.scale_factor = 1.0
    viewer.show_hidden_areas = False
    return viewer

解码所有 PDF 页面

使用 decode_all_pages() 当您想将 PDF 中的每一页转换为单独的图像时，返回的页面图像随后可以逐个保存到输出目录中。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def decode_all_pages(infile: str, output_dir: str) -> None:
    """Decode all pages of a PDF document into image files."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        decoded_pages = viewer.decode_all_pages()

        for index, page_image in enumerate(decoded_pages, start=1):
            image_path = path.join(output_dir, f"decode_all_pages_{index}.png")
            page_image.save(image_path)
    finally:
        viewer.close_pdf_file()

解码特定的 PDF 页面

使用 decode_page() 当您只需要文档中的单页时。这在生成预览、缩略图或特定页面的导出时非常有用。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def decode_specific_page(infile: str, outfile: str, page_number: int = 1) -> None:
    """Decode a specific PDF page into an image file."""
    viewer = _create_viewer()
    try:
        viewer.bind_pdf(infile)
        page_image = viewer.decode_page(page_number)
        page_image.save(outfile)

    finally:
        viewer.close()

检查 PDF 元数据

这 inspect_pdf_metadata 函数演示如何使用 Aspose.PDF 打开 PDF 文档并检索基本的与查看器相关的元数据。它侧重于提取描述文档如何被解释和显示的信息，而不是其内容。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def inspect_pdf_metadata(infile: str) -> None:
    """Open a PDF and print page-count related viewer metadata."""
    viewer = _create_viewer()
    try:
        viewer.open_pdf_file(infile)
        print(f"Page count: {viewer.page_count}")
        print(f"Coordinate type: {viewer.coordinate_type}")
        print(f"Resolution: {viewer.resolution}")
    finally:
        viewer.close_pdf_file()

Python-Net: Form 类

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

Python-Net: Stamp 类

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

Aspose.PDF for Python via .NET 提供了印章用于在 PDF 页面上放置可重复使用的可视内容的类。Stamp 可以基于文字、图像，甚至来自其他 PDF 的页面，并且可以定位、旋转、设置样式，并限制在特定页面上。

本文演示了几种常见的印章工作流：

为基于文本的印章创建可重复使用的文本资源。
添加图像和 PDF 页面印章。
添加样式化文本印章。
将印章限制在所选页面。
配置背景图像印章。

该示例使用两个辅助函数：一个用于创建基于文本的印章的格式化文本，另一个用于创建 TextState 用于设置文本印章样式的对象。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def _create_text_logo(text: str) -> pdf_facades.FormattedText:
    """Create formatted text for text stamp examples."""
    return pdf_facades.FormattedText(
        text,
        drawing.Color.blue,
        drawing.Color.light_gray,
        pdf_facades.FontStyle.HELVETICA_BOLD,
        pdf_facades.EncodingType.WINANSI,
        True,
        14,
    )


def _create_text_state() -> ap.text.TextState:
    """Create a text state used to style text stamps."""
    text_state = ap.text.TextState()
    text_state.foreground_color = ap.Color.dark_blue
    text_state.font_size = 16
    text_state.font_style = ap.text.FontStyles.BOLD
    return text_state

添加图像印章

使用 bind_image() 当印章应显示图像（例如徽标、徽章或图标）时。绑定图像后，您可以在将其添加到文档之前设置印章 ID 和原点。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp to the PDF."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.stamp_id = 1
        stamp.set_origin(36, 520)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

将 PDF 页面添加为印章

使用 bind_pdf() 当您想要使用另一个 PDF 文件中的页面作为印章内容时。这对于覆盖层（例如批准、模板或存储在单独文档中的预构建视觉元素）非常有用。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_pdf_page_as_stamp(infile: str, stamp_pdf: str, outfile: str) -> None:
    """Add the first page of another PDF as a stamp."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_pdf(stamp_pdf, 1)
        stamp.page_number = 1
        stamp.set_origin(36, 250)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

添加带文本状态的文字印章

使用 bind_logo() 以及 bind_text_state() 当您想要创建具有自定义字体样式的基于文本的印章时。此方法适用于审批标记、标签以及工作流特定的注释。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_text_stamp_with_text_state(infile: str, outfile: str) -> None:
    """Add a text stamp and style it with a TextState object."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_logo(_create_text_logo("Approved by signing workflow"))
        stamp.bind_text_state(_create_text_state())
        stamp.set_origin(36, 700)
        stamp.rotation = 15.0

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

在特定页面添加印章

如果印章不应出现在每一页上，请将目标页码分配给 pages 属性。此示例仅在首页添加图像印章。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_stamp_to_specific_pages(infile: str, image_file: str, outfile: str) -> None:
    """Add an image stamp only to the selected pages."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.pages = [1]
        stamp.set_origin(400, 40)
        stamp.set_image_size(120, 60)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

添加背景图像印章

当图像应显示在页面内容后面时，使用背景印章。您还可以控制印章的不透明度、旋转、质量、大小和位置，以创建水印样式的效果。

import sys
from os import path

import aspose.pdf as ap
import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as drawing

from config import initialize_data_dir, set_license


def add_background_image_stamp(infile: str, image_file: str, outfile: str) -> None:
    """Add a rotated background image stamp with opacity and quality settings."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)
        stamp.is_background = True
        stamp.opacity = 0.35
        stamp.quality = 90
        stamp.rotation = 45.0
        stamp.set_image_size(160, 80)
        stamp.set_origin(200, 300)

        pdf_stamper.add_stamp(stamp)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: PdfFileStamp 类

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

这 PdfFileStamp Aspose.PDF Facades 中的 class 旨在向 PDF 页面添加重复的可视内容。当您需要在文档中应用页眉、页脚、页码或水印，而无需手动编辑每一页时，它非常有用。

使用 PdfFileStamp 可以做的事

使用本节中的文章来探索该支持的主要盖章任务 PdfFileStamp 外观:

Documentation – 使用 PDF Facades

Python-Net: PdfFileEditor 类

使用 PdfFileEditor 可以做什么

PdfFileEditor 教程

Python-Net: PdfContentEditor 类

使用 PdfContentEditor 可以做什么

Python-Net: PdfAnnotationEditor 类

PdfAnnotationEditor 的用途是什么

Python-Net: PdfFileSignature 类

准备 PDF 数字签名助手

此设置实现的目标

Python-Net: FormEditor 类

常见 FormEditor 任务

Python-Net: PdfFileInfo 类

使用 PdfFileInfo 可以做什么

Python-Net: PdfFileSecurity 类

使用 PdfFileSecurity 可以做什么

Python-Net: PdfViewer 类

创建可复用的 PdfViewer 辅助类

解码所有 PDF 页面

解码特定的 PDF 页面

检查 PDF 元数据

Python-Net: Form 类

Python-Net: Stamp 类

添加图像印章

将 PDF 页面添加为印章

添加带文本状态的文字印章

在特定页面添加印章

添加背景图像印章

相关外观主题

Python-Net: PdfFileStamp 类

使用 PdfFileStamp 可以做的事