Documentation – Работа с фасадами PDF

Python-Net: Класс PdfFileEditor

Mon, 05 Jan 2026 00:00:00 +0000

Работа с PDF‑документами включает различные функции. Управление страницами PDF‑файла является важной частью этой задачи. ‘aspose.pdf.facades’ предоставляет PdfFileEditor класс для этой цели.

Класс PdfFileEditor содержит методы, помогающие управлять отдельными страницами; этот класс не редактирует и не изменяет содержимое страницы. Вы можете вставить новую страницу, удалить существующую, разделить страницы или задать их импозицию с помощью PdfFileEditor.

Что вы можете сделать с PdfFileEditor

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

Руководства по PdfFileEditor

Python-Net: Класс PdfContentEditor

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

PdfContentEditor Класс в Aspose.PDF Facades предназначен для задач редактирования на уровне содержимого в существующих PDF‑документах. Он предоставляет упрощённый API для обновления интерактивных элементов, замены текста, работы с вложениями и ссылками, а также настройки поведения документа в приложениях Python via .NET.

Что можно сделать с PdfContentEditor

Используйте этот раздел, чтобы изучить основные области редактирования содержимого PDF, поддерживаемые PdfContentEditor фасад:

Python-Net: Класс PdfAnnotationEditor

Thu, 05 Feb 2026 00:00:00 +0000

PdfAnnotationEditor к+ласс в Aspose.PDF Facades предназначен для работы с PDF‑аннотациями и разметкой на основе комментариев без необходимости вручную редактировать низкоуровневую структуру документа. Он предоставляет упрощённый способ обработки процессов аннотирования в Python via .NET, когда требуется просматривать или обновлять существующие PDF‑файлы.

Для чего используется PdfAnnotationEditor

Используйте этот фасад, когда ваш процесс работы с PDF включает аннотации, комментарии по обзору или другие элементы разметки, которые необходимо управлять программно. По мере расширения этого раздела он должен служить целевой страницей для учебных материалов, связанных с аннотациями, построенных вокруг PdfAnnotationEditor класс.

Python-Net: Класс PdfFileSignature

Mon, 05 Jan 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

Thu, 05 Mar 2026 00:00:00 +0000

Следующий FormEditor Класс в Aspose.PDF Facades предназначен для создания и обновления интерактивных полей формы PDF. Он помогает строить структуру формы, настраивать свойства полей, изменять параметры внешнего вида и прикреплять интерактивное поведение, такое как скрипты и действия отправки, в приложениях Python.

Общие задачи FormEditor

Используйте следующие учебники для работы с основными возможностями данного FormEditor:

Python-Net: Класс PdfFileInfo

Thu, 19 Mar 2026 00:00:00 +0000

PdfFileInfo Класс в Aspose.PDF Facades предоставляет доступ к информации уровня документа и уровня страницы PDF без необходимости низкоуровневого парсинга. Он полезен, когда требуется проверять метаданные, получать свойства документа, проверять привилегии или изучать размеры страниц и смещения в автоматических рабочих процессах.

Что вы можете сделать с PdfFileInfo

Используйте статьи в этом разделе, чтобы исследовать основные возможности инспекции файлов PdfFileInfo фасад:

Python-Net: Класс PdfFileSecurity

Wed, 18 Mar 2026 00:00:00 +0000

Этот PdfFileSecurity класс в Aspose.PDF Facades используется для защиты PDF‑документов и управления тем, как пользователи взаимодействуют с ними. Он поддерживает общие сценарии безопасности, такие как шифрование на основе пароля, дешифрование, ротация паролей и управление разрешениями для печати, копирования и редактирования.

Что вы можете сделать с PdfFileSecurity

Используйте статьи в этом разделе, чтобы изучить основные задачи безопасности PDF, поддерживаемые PdfFileSecurity фасад:

Python-Net: Класс Form

Wed, 05 Nov 2025 00:00:00 +0000

Python-Net: Класс Stamp

Mon, 13 Apr 2026 00:00:00 +0000

Aspose.PDF for Python via .NET предоставляет Stamp класс для размещения переиспользуемого визуального контента на страницах PDF. Штамп может быть основан на тексте, изображении или даже на странице из другого 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() когда штамп должен отображать изображение, такое как логотип, значок или иконка. После привязки изображения вы можете установить идентификатор штампа и его исходную точку перед добавлением его в документ.

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()

Добавление TextStamp с текстовым состоянием

Используйте 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()

Добавление фонового ImageStamp

Используйте фоновый штамп, когда изображение должно располагаться позади содержимого страницы. Вы также можете управлять непрозрачностью штампа, его поворотом, качеством, размером и положением, чтобы создать эффекты в стиле водяного знака.

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

Tue, 14 Apr 2026 00:00:00 +0000

Этот PdfFileStamp класс в Aspose.PDF Facades предназначен для добавления повторяющегося визуального контента на страницы PDF. Он полезен, когда нужно применить заголовки, колонтитулы, номера страниц или штампы во всём документе без ручного редактирования каждой страницы.

Что вы можете сделать с PdfFileStamp

Используйте статьи в этом разделе, чтобы исследовать основные задачи штамповки, поддерживаемые PdfFileStamp фасад: