Documentation – Класс PdfFileStamp

Python-Net: Добавить нижний колонтитул в PDF

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

Aspose.PDF for Python via .NET предоставляет PdfFileStamp фасад для добавления повторяющегося контента на страницы PDF. Вы можете использовать его для размещения текста или изображений в нижнем колонтитуле внизу каждой страницы и настроить отступы нижнего колонтитула для управления размещением.

Добавление текстового нижнего колонтитула

Используйте add_footer() с FormattedText объект, когда вы хотите разместить одинаковый текстовый нижний колонтитул на каждой странице PDF. Второй аргумент задает отступ снизу, используемый для размещения нижнего колонтитула.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_text_footer(infile: str, outfile: str) -> None:
    """Add a text footer with a bottom margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("Sample Footer")
        pdf_stamper.add_footer(text, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Добавление изображения в нижний колонтитул

Используйте add_footer() с потоковым изображением, когда нижний колонтитул должен отображать логотип или другое изображение вместо текста. В примере файл изображения открывается как бинарный поток и размещается внизу каждой страницы.

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_image_footer(infile: str, image_file: str, outfile: str) -> None:
    """Add an image footer with a bottom margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_footer(image_file, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Добавьте нижний колонтитул с пользовательскими отступами

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

import sys
from os import path
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_footer_with_margins(infile: str, outfile: str) -> None:
    """Add a text footer with bottom, left, and right margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("This footer has margins on all sides.")
        pdf_stamper.add_footer(text, 20, 20, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: Добавить заголовок в PDF

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

Aspose.PDF for Python via .NET предоставляет PdfFileStamp фасад для добавления повторяющегося контента на страницы PDF. Вы можете использовать его для размещения текста заголовка или изображений в верхней части каждой страницы и настройки отступов заголовка для контроля позиционирования.

Добавление текстового заголовка

Используйте add_header() с FormattedText объект, когда вы хотите разместить один и тот же текст заголовка на каждой странице PDF. Второй аргумент определяет верхний отступ для заголовка.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_text_header(infile: str, outfile: str) -> None:
    """Add a text header with a top margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText("Sample Header")
        pdf_stamper.add_header(text, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Добавление заголовок с изображением

Используйте add_header() с файлом изображения или потоком изображения, когда в заголовке должен отображаться логотип или другая графика. Это полезно для фирменных макетов документов.

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_image_header(infile: str, image_file: str, outfile: str) -> None:
    """Add an image header with a top margin."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_header(image_file, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Добавьте заголовок с пользовательскими отступами

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

import sys
from os import path

import aspose.pydrawing as ap_pydrawing
import aspose.pdf.facades as pdf_facades

from config import initialize_data_dir, set_license


def add_header_with_margins(infile: str, outfile: str) -> None:
    """Add a text header with top, left, and right margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        text = pdf_facades.FormattedText(
            text="Sample Header",
            text_color=ap_pydrawing.Color.blue,
            font_name="Arial",
            text_encoding=pdf_facades.EncodingType.WINANSI,
            embedded=True,
            font_size=12.0,
        )
        pdf_stamper.add_header(text, 20, 20, 20)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Python-Net: Добавить номер страницы в PDF

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

Aspose.PDF for Python via .NET предоставляет PdfFileStamp Facade для добавления повторяющегося контента на страницы PDF. Вы можете использовать её для вставки номеров страниц с размещением по умолчанию, позиционирования их в определённых координатах или управления их выравниванием и отступами.

Добавление номера страниц с размещением по умолчанию

Используйте add_page_number() без дополнительных аргументов позиции, когда вы хотите, чтобы номера страниц добавлялись в месте по умолчанию. Это самый простой способ пронумеровать каждую страницу в документе.

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 add_page_numbers_default(infile: str, outfile: str) -> None:
    """Add centered page numbers to the bottom of each page."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number("Page #")
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Добавление номера страниц в пользовательских координатах

Используйте перегрузку на основе координат, когда вам нужно, чтобы номера страниц отображались в конкретных позициях X и Y на каждой странице. Такой подход полезен, когда макет документа требует пользовательского размещения.

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 add_page_numbers_at_coordinates(infile: str, outfile: str) -> None:
    """Add page numbers at explicit X/Y coordinates."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number("Page #", 300, 20)
        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

from config import initialize_data_dir, set_license


def add_page_numbers_with_position_and_margins(infile: str, outfile: str) -> None:
    """Add page numbers using a predefined position and page margins."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.add_page_number(
            "Page #",
            pdf_facades.PdfFileStamp.POS_BOTTOM_RIGHT,
            10,
            10,
            10,
            10,
        )
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

Добавление нумерацию страниц в римском стиле

Функция ‘add_page_numbers_with_roman_style’ демонстрирует, как улучшить PDF‑документ, добавив нумерацию страниц с использованием заглавных римских цифр. Она использует класс PdfFileStamp из Aspose.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 add_page_numbers_with_roman_style(infile: str, outfile: str) -> None:
    """Add page numbers with a custom start value and Roman numbering."""
    pdf_stamper = pdf_facades.PdfFileStamp()
    try:
        pdf_stamper.bind_pdf(infile)
        pdf_stamper.numbering_style = ap.NumberingStyle.NUMERALS_ROMAN_UPPERCASE
        pdf_stamper.starting_number = 42
        pdf_stamper.add_page_number("Page #", pdf_facades.PdfFileStamp.POS_UPPER_RIGHT)
        pdf_stamper.save(outfile)
    finally:
        pdf_stamper.close()

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

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

Aspose.PDF for Python via .NET предоставляет PdfFileStamp Фасад для добавления повторяющегося контента на страницы PDF. Помимо заголовков, нижних колонтитулов и номеров страниц, его можно использовать для размещения текстовых штампов на каждой странице документа.

Добавление штамп в PDF

После настройки штампа привяжите входной PDF к PdfFileStamp, добавить штамп, и сохранить выходной файл. Это применяет настроенный штамп по всему документу.

import sys
from os import path

import aspose.pdf.facades as pdf_facades

CURRENT_DIR = path.dirname(__file__)
EXAMPLES_DIR = path.abspath(path.join(CURRENT_DIR, "..", ".."))
if EXAMPLES_DIR not in sys.path:
    sys.path.insert(0, EXAMPLES_DIR)

from config import initialize_data_dir, set_license


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

        stamp = pdf_facades.Stamp()
        stamp.bind_image(image_file)

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