Documentation – 印章管理

Python-Net: 添加橡胶印章

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

橡胶印章注释通常用于 PDF 中，以指示批准、审阅状态或其他备注。使用 PdfContentEditor，您可以为印章定义矩形，设置其文本和注释，选择颜色，并将其应用于文档的多个页面。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
循环遍历第 1–4 页。
添加带有自定义文本、注释和颜色的橡胶印章注释。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def add_rubber_stamp(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    for i in range(1, 5):
        content_editor.create_rubber_stamp(
            i,
            apd.Rectangle(120, 450, 180, 60),
            "Approved",
            "Approved by reviewer",
            apd.Color.green,
        )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 使用外观文件创建橡皮图章

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

橡皮图章注释不仅可以使用文本进行自定义，还可以通过使用图像文件作为其外观进行定制。这种方法对于在 PDF 页面上添加公司徽标、签名图章或任何视觉指示器非常有用。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为图章定义一个矩形。
使用自定义图像文件来定义橡皮图章的外观。
设置图章的文本和颜色。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def create_rubber_stamp_with_appearance_file(infile, image_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create rubber stamp using appearance_file overload (image path)
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(100, 400, 200, 60),
        "Stamp with custom appearance",
        apd.Color.dark_green,
        image_file,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 使用外观流创建橡皮图章

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

可以使用外部图像文件自定义橡皮图章注释。与仅依赖基于文本的图章不同，您可以定义视觉外观（例如公司徽标或批准徽章），并将其放置在页面上。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
为图章位置定义一个矩形。
使用图像文件作为印章外观。
应用文本和颜色设置。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def create_rubber_stamp_with_appearance_file(infile, image_file, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # Create rubber stamp using appearance_file overload (image path)
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(100, 400, 200, 60),
        "Stamp with custom appearance",
        apd.Color.dark_green,
        image_file,
    )
    # Save updated document
    content_editor.save(outfile)

Python-Net: 按索引删除印章

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

当页面上存在多个橡皮图章时，您可以使用其索引删除特定的图章。delete_stamp() 方法允许按照顺序删除注释，这在您不跟踪印章 ID 但知道其顺序时非常有用。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
使用 bind_pdf(infile) 将输入 PDF 文件绑定到 PdfContentEditor 实例。
调用 ‘delete_stamp(1, [2, 3])’ 来删除索引为 1 的印章，在第 2 页和第 3 页。
使用 save(outfile) 将修改后的 PDF 文档保存到输出文件。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def delete_stamp_by_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    content_editor.delete_stamp(1, [2, 3])
    # Save updated document
    content_editor.save(outfile)

Python-Net: 全局删除印章

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

在处理多页文档时，您可能需要在整个文档中删除某些印章。‘delete_stamp_by_id()’ 和 ‘delete_stamp_by_ids()’ 方法允许您通过标识符全局删除印章，无需手动遍历每一页。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
在多个页面上添加橡胶印章。
使用其 ID 全局删除印章。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def delete_stamps_globally(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    # Add stamps across multiple pages so global deletion is meaningful
    for page in range(1, 5):
        content_editor.create_rubber_stamp(
            page,
            apd.Rectangle(120, 500, 180, 60),
            "Draft",
            "Stamp for global deletion",
            apd.Color.gray,
        )

    # delete_stamp_by_id without page number removes stamp ID from all pages
    content_editor.delete_stamp_by_id(1)
    # delete_stamp_by_ids without page number removes a list of IDs from all pages
    content_editor.delete_stamp_by_ids([2, 3])

    # Save updated document
    content_editor.save(outfile)

Python-Net: 列出印章

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

在处理带有注释的 PDF 时，您可能需要在修改或删除之前检查现有的橡胶印章。‘get_stamps()’ 方法允许您检索特定页面上放置的所有印章。随后您可以遍历结果并以编程方式处理它们。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
检索第 1 页的所有印章。
遍历印章集合。
打印每个印章。
如果不存在印章，显示一条消息。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def list_stamps(infile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)
    # List all stamps on page 1
    stamps = content_editor.get_stamps(1)

    count = 0
    for stamp in stamps:
        count += 1
        print(f"Stamp {count}: {stamp}")

    if count == 0:
        print("No stamps found")

Python-Net: 通过 ID 移动印章

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

在 PDF 中添加橡胶印章注释后，可能需要调整其位置。‘move_stamp_by_id()’ 方法允许您基于标识符重新定位印章，而无需重新创建。这在需要动态调整印章放置的自动化工作流中非常有用。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
添加橡胶印章注释。
使用其 ID 移动印章。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def move_stamp_by_id_example(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(300, 420, 180, 60),
        "Approved",
        "Move this stamp by ID",
        apd.Color.green,
    )

    # Move stamp by ID overload
    content_editor.move_stamp_by_id(1, 1, 240, 360)

    # Save updated document
    content_editor.save(outfile)

Python-Net: 按 ID 删除印章

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

在处理包含多个印章的 PDF 时，通常需要在不影响其他印章的情况下删除特定印章。使用基于 ID 的删除，您可以精准控制要删除的印章：

‘delete_stamp_by_id(stamp_id, page_number)’ – 删除特定页面上按其 ID 的单个印章
‘delete_stamp_by_ids(page_number, stamp_ids)’ – 删除给定页面上按其 ID 的多个印章

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
添加两个具有不同 ID 的橡皮图章。
使用单 ID 和多 ID 删除方法删除图章。
保存更新后的 PDF。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def delete_stamp_by_ids_examples(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    # Create two stamps on page 1 so they can be deleted by ID
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(120, 320, 180, 60),
        "Draft",
        "Delete by single ID",
        apd.Color.orange,
    )
    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(120, 250, 180, 60),
        "Draft",
        "Delete by multiple IDs",
        apd.Color.orange,
    )

    # Delete by single ID overload and by IDs overload
    content_editor.delete_stamp_by_id(1, 1)
    content_editor.delete_stamp_by_ids(1, [2])

    # Save updated document
    content_editor.save(outfile)

Python-Net: 按索引移动印章

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

在 PDF 编辑中，可能需要调整现有橡胶印章的位置。此代码片段展示了如何：

在同一页面上添加多个印章
使用它们的索引准备重新定位。
可选地通过指定其页面、索引和新坐标来移动印章。

‘move_stamp(page_number, stamp_index, new_x, new_y)’ 方法可以精确地重新定位印章。

创建一个 PdfContentEditor 对象。
将 PDF 绑定到编辑器。
向页面添加多个橡胶印章。
在执行移动操作之前保存文档。
根据索引移动特定的印章。
保存更新后的 PDF。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def move_stamp_by_index(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )
    content_editor.save(outfile)

    # Move first stamp on page 1 by index
    # content_editor.move_stamp(1, 1, 10, 10)
    # Save updated document
    content_editor.save(outfile)

Python-Net: 按 ID 管理印章

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

在包含多个橡胶印章的 PDF 中，基于 ID 控制各个印章可能很有用。‘hide_stamp_by_id()’ 和 ‘show_stamp_by_id()’ 方法允许有选择地控制可见性。本示例展示了如何：

添加具有唯一 ID 的多个印章
隐藏特定页面上的印章
在另一页显示印章

通过使用基于 ID 的操作，您可以避免按页面位置或其他属性跟踪印章。

创建一个 PdfContentEditor 实例。
绑定输入的 PDF 文档。
添加具有特定 ID 的橡皮图章。
根据其 ID 和页码隐藏和显示印章。
保存更新后的 PDF 文档。

import aspose.pdf.facades as pdf_facades
import aspose.pydrawing as apd
from io import BytesIO
import sys
from os import path

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

from config import set_license, initialize_data_dir


def manage_stamp_by_id(infile, outfile):
    # Create PdfContentEditor object
    content_editor = pdf_facades.PdfContentEditor()
    # Bind document to PdfContentEditor
    content_editor.bind_pdf(infile)

    content_editor.create_rubber_stamp(
        1,
        apd.Rectangle(200, 380, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    content_editor.create_rubber_stamp(
        2,
        apd.Rectangle(200, 480, 180, 60),
        "Draft",
        "Draft stamp for ID-based operations",
        apd.Color.orange,
    )

    # Apply ID-based stamp operations
    content_editor.hide_stamp_by_id(1, 1)
    content_editor.show_stamp_by_id(1, 2)

    # Save updated document
    content_editor.save(outfile)