Documentation – Управление штампами

Python-Net: Добавить штамп

Fri, 20 Mar 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: Создать резиновый штамп с файлом внешнего вида

Fri, 20 Mar 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: Создать резиновую печать с потоком отображения

Fri, 20 Mar 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: Переместить штамп по индексу

Fri, 20 Mar 2026 00:00:00 +0000

Когда на странице присутствует несколько резиновых штампов, вы можете переместить конкретный, указав его индекс. Метод move_stamp() позволяет изменять позицию аннотаций согласно их последовательности, что полезно, если вы не отслеживаете идентификаторы штампов, а знаете их порядок.

Создайте 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: Удалить штампы глобально

Fri, 20 Mar 2026 00:00:00 +0000

При работе с несколькими страницами может потребоваться удалить определённые штампы по всему документу. Методы ‘delete_stamp_by_id()’ и ‘delete_stamp_by_ids()’ позволяют удалять штампы глобально по их идентификаторам, устраняя необходимость проходить каждую страницу вручную.

Создайте 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 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: Список штампов

Fri, 20 Mar 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

Fri, 20 Mar 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

Fri, 20 Mar 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‑документ.
Добавьте две резиновые печати с разными идентификаторами.
Удаляйте печати, используя как методы удаления по одному идентификатору, так и методы удаления по нескольким идентификаторам.
Сохраните обновлённый 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: Переместить штамп по индексу

Fri, 20 Mar 2026 00:00:00 +0000

При редактировании PDF может потребоваться скорректировать положение существующих резиновых печатей. Этот фрагмент кода показывает, как:

Добавить несколько печатей на одной странице
Подготовить их к перемещению, используя их индекс
Опционально переместить штамп, указав его страницу, индекс и новые координаты

Метод ‘move_stamp(page_number, stamp_index, new_x, new_y)’ может точно переместить штампы.

Создайте PdfContentEditor object.
Привяжите 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: Управление штампом по идентификатору

Fri, 20 Mar 2026 00:00:00 +0000

В PDF с несколькими резиновыми штампами может быть полезно управлять отдельными штампами на основе их ID. Методы ‘hide_stamp_by_id()’ и ‘show_stamp_by_id()’ позволяют избирательно контролировать видимость. Этот пример показывает, как:

Добавить несколько штампов с уникальными ID
Скрыть печать на определённой странице
Показать печать на другой странице

Используя операции на основе ID, вы избегаете отслеживания печатей по позиции страницы или другим атрибутам.

Создайте 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 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)