Documentation – 在 Python 中使用 PDF 工件

Python-Net: 在 Python 中为 PDF 添加贝茨编号

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

Bates 编号广泛用于法律、医疗和商务工作流中，为文档集中的页面分配唯一的、顺序的标识符。Aspose.PDF for Python via .NET 提供了简洁且灵活的 API 来自动化此过程，使您能够以编程方式在任何 PDF 上应用标准化的 Bates 编号。

使用 BatesNArtifact 类，开发者可以完全自定义编号行为——包括起始号码、位数、前缀和后缀、对齐方式以及边距。配置完成后，artifact 可以应用于 Document 通过 add_bates_numbering 方法在 PageCollection 或作为列表的一部分添加 PaginationArtifact objects. Aspose.PDF 也支持基于委托的配置风格，允许在运行时动态控制工件设置。

除了创建 Bates 编号之外，API 还提供了一种简便的方法来删除它们 delete_bates_numbering，在文档处理工作流中提供完全的灵活性。

本文展示了使用 Aspose.PDF for Python via .NET 在 PDF 中添加和删除 Bates 编号的多种方法，并提供了关于工件配置、应用和移除的清晰示例。

添加 Bates 编号工件

此示例演示如何使用 Aspose.PDF for Python via .NET 以编程方式向 PDF 文档添加 Bates 编号。通过配置一个 BatesNArtifact 使用所需的设置并将其应用于文档的页面，您可以实现自动化，为每页添加标准化标识符的过程。

要向一个 Bates 编号工件添加 Document，调用 AddBatesNumbering(BatesNArtifact) 扩展方法 PageCollection，传入一个 BatesNArtifact 实例作为参数：

import sys
from os import path
import aspose.pdf as ap

def _create_bates_artifact():
    """Create a Bates numbering artifact with default settings."""
    artifact = ap.BatesNArtifact()
    artifact.start_page = 1
    artifact.end_page = 0
    artifact.subset = ap.Subset.ALL
    artifact.number_of_digits = 6
    artifact.start_number = 1
    artifact.prefix = ""
    artifact.suffix = ""
    artifact.artifact_vertical_alignment = ap.VerticalAlignment.BOTTOM
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.RIGHT
    artifact.right_margin = 72
    artifact.left_margin = 72
    artifact.top_margin = 36
    artifact.bottom_margin = 36
    return artifact

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact(infile, outfile):
    """Add Bates numbering artifact to a PDF document."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_bates_numbering(document.pages, bates_artifact)
        document.save(outfile)

使用分页工件添加贝茨编号

使用 Aspose.PDF for Python 中的分页工件集合为 PDF 添加贝茨编号：

加载 PDF 文档。
在应用页码之前，如有需要插入额外的页面。
创建一个 Bates 工件。
配置工件属性。
将该工件添加到分页集合中。
对页面应用分页。
保存更新后的文档。

import sys
from os import path
import aspose.pdf as ap

def add_bates_n_artifact_pagination(infile, outfile):
    """Add Bates numbering using pagination artifacts collection."""
    with ap.Document(infile) as document:
        for _ in range(2):
            document.pages.add()

        bates_artifact = _create_bates_artifact()
        ap.PageCollectionExtensions.add_pagination(document.pages, [bates_artifact])
        document.save(outfile)

删除 Bates 编号

要从 a 中删除 Bates 编号 Document，使用 delete_bates_numbering() 方法在 PageCollection:

import sys
from os import path
import aspose.pdf as ap

def delete_bates_numbering(infile, outfile):
    """Delete Bates numbering from a PDF document."""
    with ap.Document(infile) as document:
        ap.PageCollectionExtensions.delete_bates_numbering(document.pages)
        document.save(outfile)

Python-Net: 在 Python 中添加 PDF 背景

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

向 PDF 添加背景图像

背景图像可用于在文档中添加水印或其他细微的设计。在 Aspose.PDF for Python via .NET 中，每个 PDF 文档都是页面的集合，每个页面包含一组工件。该 BackgroundArtifact 类可用于向页面对象添加背景图像。

当您需要在主 PDF 内容后面放置装饰性图像，而不将其转换为可搜索的文本文档时，此方法非常有用。

以下代码片段展示了如何使用 BackgroundArtifact 对象在 Python 中向 PDF 页面添加背景图像。

加载 PDF 文档。
创建背景 artifact。
加载图像文件。
将工件附加到页面。
保存更新后的文档。


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

def add_background_image_to_pdf(infile, imagefile, outfile):
    """Add a background image to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

向 PDF 添加带透明度的背景图像

使用 Aspose.PDF for Python 向 PDF 页面添加半透明背景图像。

通过应用不透明度，背景图像会变得部分透明，使原始页面内容（文字、图像等）仍然清晰可见。这在以下情况下尤其有用：

水印
品牌覆盖层
细微的设计增强

背景作为工件添加，确保它位于所有页面内容的后面。

加载 PDF 文档。
创建背景 artifact。
加载图像文件。
设置不透明度级别。
将工件附加到页面。
保存更新后的文档。


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

def add_background_image_with_opacity_to_pdf(infile, imagefile, outfile):
    """Add a background image with opacity to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_image = FileIO(imagefile, "rb")
        artifact.opacity = 0.5
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

为 PDF 添加背景颜色

使用 Aspose.PDF for Python 为 PDF 页面应用纯色背景。

加载 PDF 文档。
创建背景 artifact。
设置背景颜色。
将工件附加到页面。
保存更新后的文档。


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

def add_background_color_to_pdf(infile, outfile):
    """Add a solid color background to a PDF document as an artifact."""
    with ap.Document(infile) as document:
        artifact = ap.BackgroundArtifact()
        artifact.background_color = ap.Color.dark_khaki
        document.pages[1].artifacts.append(artifact)
        document.save(outfile)

从 PDF 中移除背景

使用 Aspose.PDF for Python 从 PDF 页面中移除背景伪影。 PDF 中的背景通常以伪影形式存储，此方法会选择性地识别并仅移除被分类为背景元素的伪影。

加载 PDF 文档。
访问页面伪影。
过滤背景伪影。
收集背景元素。
删除背景伪影。
保存更新后的文档。


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

def remove_background(infile, outfile):
    with ap.Document(infile) as document:
        backgrounds = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.BACKGROUND
        ]

        for background in backgrounds:
            document.pages[1].artifacts.delete(background)

        document.save(outfile)

Python-Net: 在 Python 中为 PDF 添加水印

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

向 PDF 添加水印工件 Document 使用 Aspose.PDF for Python via .NET。水印是应用于页面的可视化覆盖层，用于品牌化、安全或信息目的。示例展示了如何配置 TextState 外观、定位与 HorizontalAlignment 和 VerticalAlignment，旋转和透明度在将水印应用于 Page.

从 PDF 中提取水印

加载 PDF 文档。
访问页面伪影。
过滤水印伪影。
收集水印元素。
提取水印属性。
输出水印信息。

from os import path
import sys
import aspose.pdf as ap

def extract_watermark_from_pdf(infile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            print(f"{watermark.text} {watermark.rectangle}")

向 PDF 添加水印

使用 Aspose.PDF for Python 向 PDF 文档添加文本水印：

加载 PDF 文档。
创建文本状态。
创建水印工件。
设置水印文本和样式。
配置位置和旋转。
设置不透明度和背景行为。
将水印附加到页面。
保存更新后的文档。

from os import path
import sys
import aspose.pdf as ap

def add_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        text_state = ap.text.TextState()
        text_state.font_size = 72
        text_state.foreground_color = ap.Color.blue_violet
        text_state.font_style = ap.text.FontStyles.BOLD
        text_state.font = ap.text.FontRepository.find_font("Arial")

        watermark = ap.WatermarkArtifact()
        watermark.set_text_and_state("WATERMARK", text_state)
        watermark.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
        watermark.artifact_vertical_alignment = ap.VerticalAlignment.CENTER
        watermark.rotation = 60
        watermark.opacity = 0.2
        watermark.is_background = True

        document.pages[1].artifacts.append(watermark)
        document.save(outfile)

删除 PDF 页面上的水印伪影

使用 Aspose.PDF for Python API 从 PDF 文档的特定页面中删除水印伪影。该方法针对存储为页面伪影的水印元素（特别是被归类为分页水印子类型的元素），遍历它们并在保存更新后的文档之前将其删除。

加载 PDF 文档。
访问页面伪影。
过滤水印伪影。
删除水印伪影。
保存更新后的文档。

from os import path
import sys
import aspose.pdf as ap

def delete_watermark_artifact(infile, outfile):
    with ap.Document(infile) as document:
        watermarks = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and artifact.subtype == ap.Artifact.ArtifactSubtype.WATERMARK
        ]

        for watermark in watermarks:
            document.pages[1].artifacts.delete(watermark)

        document.save(outfile)

Python-Net: 在 Python 中统计 PDF 工件

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

统计特定类型的工件

检查并计数 PDF 中的分页工件 Document 使用 Aspose.PDF for Python via .NET。分页工件包括水印、背景、页眉和页脚等元素，这些元素被应用于页面以进行布局和标识目的。通过过滤 Artifact 对象在 a Page 并按子类型分组（Artifact.ArtifactSubtype），开发人员可以快速分析文档的结构并验证特定元素的存在。

要计算特定类型工件的总数（例如，水印的总数），请使用以下代码。示例过滤页面的 Artifacts 集合 (一个 ArtifactCollection) 通过 Artifact.ArtifactType 然后计数子类型（Artifact.ArtifactSubtype).

打开 PDF 文档（参见 Document).
使用页面的过滤分页伪像 Artifacts 集合。
按子类型统计工件 (Artifact.ArtifactSubtype).
打印结果。


from os import path
from collections import Counter
import sys
import aspose.pdf as ap

def count_pdf_artifacts(infile):
    """Count and display artifacts of different types on the first page."""
    with ap.Document(infile) as document:
        pagination_artifacts = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
        ]

        subtypes = [artifact.subtype for artifact in pagination_artifacts]
        counts = Counter(subtypes)

        print(f"Watermarks: {counts.get(ap.Artifact.ArtifactSubtype.WATERMARK, 0)}")
        print(f"Backgrounds: {counts.get(ap.Artifact.ArtifactSubtype.BACKGROUND, 0)}")
        print(f"Headers: {counts.get(ap.Artifact.ArtifactSubtype.HEADER, 0)}")
        print(f"Footers: {counts.get(ap.Artifact.ArtifactSubtype.FOOTER, 0)}")

Python-Net: 使用 Python 管理 PDF 页眉和页脚

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

创建样式化文本痕迹

此实用函数说明了如何使用 Aspose.PDF for Python 为 PDF 页面创建可重用的文本工件。它旨在生成具有一致格式的样式化页眉或页脚，包括字体设置、颜色、大小和对齐方式。该函数对工件的创建进行抽象，以便在不同的页面级文本装饰中重复使用。

实例化工件对象。
设置工件文本内容。
应用文本样式。
设置对齐。
返回已配置的工件。

from os import path
import aspose.pdf as ap
import sys

def _create_text_artifact(artifact_class, text):
    """Create a text artifact (header/footer) with common styling."""
    artifact = artifact_class()
    artifact.text = text
    artifact.text_state.font_size = 14
    artifact.text_state.font = ap.text.FontRepository.find_font("Arial")
    artifact.text_state.foreground_color = ap.Color.navy
    artifact.artifact_horizontal_alignment = ap.HorizontalAlignment.CENTER
    return artifact

向 PDF 添加页眉

打开输入的 PDF。
创建一个 HeaderArtifact，文本为 “Sample Header”。
将其追加到第一页。
保存更新后的 PDF。

from os import path
import aspose.pdf as ap
import sys

def add_header_artifact(infile, outfile):
    """Add a header artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        header = _create_text_artifact(ap.HeaderArtifact, "Sample Header")
        document.pages[1].artifacts.append(header)
        document.save(outfile)

向 PDF 添加页脚

打开输入的 PDF。
创建一个 FooterArtifact，文本为 “Sample Footer”。
将其追加到第一页。
保存输出文件。

from os import path
import aspose.pdf as ap
import sys

def add_footer_artifact(infile, outfile):
    """Add a footer artifact to the first page of a PDF document."""
    with ap.Document(infile) as document:
        footer = _create_text_artifact(ap.FooterArtifact, "Sample Footer")
        document.pages[1].artifacts.append(footer)
        document.save(outfile)

删除页眉或页脚工件

打开 PDF。
查找标记为分页页眉或页脚的伪件。
将它们从首页中移除。
保存已清理的文档。

from os import path
import aspose.pdf as ap
import sys

def delete_header_footer_artifact(infile, outfile):
    with ap.Document(infile) as document:
        header_footers = [
            artifact
            for artifact in document.pages[1].artifacts
            if artifact.type == ap.Artifact.ArtifactType.PAGINATION
            and (
                artifact.subtype == ap.Artifact.ArtifactSubtype.HEADER
                or artifact.subtype == ap.Artifact.ArtifactSubtype.FOOTER
            )
        ]

        for art in header_footers:
            document.pages[1].artifacts.delete(art)

        document.save(outfile)

Documentation – 在 Python 中使用 PDF 工件

Python-Net: 在 Python 中为 PDF 添加贝茨编号

添加 Bates 编号工件

使用分页工件添加贝茨编号

删除 Bates 编号

相关工件主题

Python-Net: 在 Python 中添加 PDF 背景

向 PDF 添加背景图像

向 PDF 添加带透明度的背景图像

为 PDF 添加背景颜色

从 PDF 中移除背景

相关工件主题

Python-Net: 在 Python 中为 PDF 添加水印

从 PDF 中提取水印

向 PDF 添加水印

删除 PDF 页面上的水印伪影

相关工件主题

Python-Net: 在 Python 中统计 PDF 工件

统计特定类型的工件

相关工件主题

Python-Net: 使用 Python 管理 PDF 页眉和页脚

创建样式化文本痕迹

向 PDF 添加页眉

向 PDF 添加页脚

删除页眉或页脚工件

相关工件主题