Documentation – Classe PdfFileStamp

Python-Net: Adicionar rodapé ao PDF

Mon, 18 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fornece o PdfFileStamp fachada para adicionar conteúdo repetido a páginas PDF. Você pode usá-la para colocar texto ou imagens de rodapé na parte inferior de cada página e ajustar as margens do rodapé para controlar a localização.

Adicionar um rodapé de texto

Usar add_footer() com um FormattedText objeto quando você deseja colocar o mesmo rodapé de texto em cada página do PDF. O segundo argumento define a margem inferior usada para a colocação do rodapé.

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

Adicionar um rodapé de imagem

Usar add_footer() com um fluxo de imagem quando o rodapé deve exibir um logotipo ou outra imagem em vez de texto. O exemplo abre o arquivo de imagem como um fluxo binário e o coloca na parte inferior de cada página.

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

Adicione um rodapé com margens personalizadas

Use a sobrecarga com três valores de margem quando precisar de mais controle sobre a posição do rodapé. Neste exemplo, o rodapé é adicionado com margens personalizadas inferior, esquerda e direita.

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: Adicionar cabeçalho ao PDF

Mon, 18 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fornece o PdfFileStamp fachada para adicionar conteúdo repetido às páginas PDF. Você pode usá-la para colocar texto de cabeçalho ou imagens no topo de cada página e ajustar as margens do cabeçalho para controlar a posição.

Adicionar um cabeçalho de texto

Usar add_header() com um FormattedText objeto quando você quer colocar o mesmo texto de cabeçalho em cada página do PDF. O segundo argumento define a margem superior para o cabeçalho.

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

Adicionar um cabeçalho de imagem

Usar add_header() com um arquivo de imagem ou fluxo de imagem quando o cabeçalho deve exibir um logo ou outro gráfico. Isso é útil para layouts de documentos com marca.

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

Adicionar um cabeçalho com margens personalizadas

Use a sobrecarga com três valores de margem quando precisar de mais controle sobre a posição do cabeçalho. Neste exemplo, o cabeçalho é adicionado com margens superiores, esquerda e direita personalizadas.

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: Adicionar número de página ao PDF

Mon, 18 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fornece o PdfFileStamp fachada para adicionar conteúdo repetido às páginas PDF. Você pode usá-la para inserir números de página com posicionamento padrão, posicioná‑los em coordenadas específicas ou controlar seu alinhamento e margens.

Adicionar números de página com o posicionamento padrão

Usar add_page_number() sem argumentos de posição adicionais quando você deseja que os números de página sejam adicionados na localização padrão. Esta é a maneira mais simples de numerar cada página do documento.

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

Adicionar números de página em coordenadas personalizadas

Use a sobrecarga baseada em coordenadas quando precisar que os números de página apareçam em uma posição X e Y específicas em cada página. Essa abordagem é útil quando o layout do documento requer um posicionamento personalizado.

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

Adicionar números de página com alinhamento e margens

Use a sobrecarga com argumentos de posição e margem quando precisar de mais controle sobre onde os números de página aparecem. Neste exemplo, os números são alinhados à área superior‑direita da página com margens explícitas.

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

Adicionar numeração de páginas no estilo romano

A função ‘add_page_numbers_with_roman_style’ mostra como aprimorar um documento PDF adicionando numeração de páginas usando numerais romanos maiúsculos. Ela utiliza a classe PdfFileStamp da Aspose.PDF para aplicar numeração consistente em todas as páginas.

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: Adicionar Carimbo ao PDF

Mon, 18 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fornece o PdfFileStamp fachada para adicionar conteúdo repetido às páginas PDF. Além de cabeçalhos, rodapés e números de página, você pode usá‑la para colocar carimbos baseados em texto em cada página de um documento.

Adicionar o carimbo ao PDF

Depois que o carimbo é configurado, vincule o PDF de entrada a PdfFileStamp, adicione o selo, e salve o arquivo de saída. Isso aplica o selo configurado em todo o documento.

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