Documentation – Clase PdfFileStamp

Python-Net: Agregar pie de pagina a PDF

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

Aspose.PDF for Python via .NET proporciona la fachada PdfFileStamp para agregar contenido repetido a paginas PDF. Puede usarla para colocar texto o imagenes de pie de pagina en la parte inferior de cada pagina y ajustar los margenes del pie de pagina para controlar la ubicacion.

Agregar un pie de pagina de texto

Use add_footer() con un objeto FormattedText cuando desee colocar el mismo texto de pie de pagina en todas las paginas del PDF. El segundo argumento establece el margen inferior usado para colocar el pie de pagina.

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

Agregar un pie de pagina de imagen

Use add_footer() con un flujo de imagen cuando el pie de pagina deba mostrar un logotipo u otra imagen en lugar de texto. El ejemplo abre el archivo de imagen como un flujo binario y lo coloca en la parte inferior de cada pagina.

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

Agregar un pie de pagina con margenes personalizados

Use la sobrecarga con tres valores de margen cuando necesite mas control sobre la ubicacion del pie de pagina. En este ejemplo, el pie de pagina se agrega con margenes inferior, izquierdo y derecho personalizados.

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: Agregar encabezado a PDF

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

Aspose.PDF for Python via .NET proporciona la fachada PdfFileStamp para agregar contenido repetido a paginas PDF. Puede usarla para colocar texto o imagenes de encabezado en la parte superior de cada pagina y ajustar los margenes del encabezado para controlar la ubicacion.

Agregar un encabezado de texto

Use add_header() con un objeto FormattedText cuando desee colocar el mismo texto de encabezado en todas las paginas del PDF. El segundo argumento define el margen superior para el encabezado.

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

Agregar un encabezado de imagen

Use add_header() con un archivo de imagen o un flujo de imagen cuando el encabezado deba mostrar un logotipo u otro grafico. Esto es util para disenos de documentos con 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()

Agregar un encabezado con margenes personalizados

Use la sobrecarga con tres valores de margen cuando necesite mas control sobre la ubicacion del encabezado. En este ejemplo, el encabezado se agrega con margenes superior, izquierdo y derecho personalizados.

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: Agregar numero de pagina a PDF

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

Aspose.PDF for Python via .NET proporciona la fachada PdfFileStamp para agregar contenido repetido a paginas PDF. Puede usarla para insertar numeros de pagina con la ubicacion predeterminada, colocarlos en coordenadas especificas o controlar su alineacion y margenes.

Agregar numeros de pagina con la ubicacion predeterminada

Use add_page_number() sin argumentos adicionales de posicion cuando desee agregar numeros de pagina en la ubicacion predeterminada. Esta es la forma mas sencilla de numerar todas las paginas del 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()

Agregar numeros de pagina en coordenadas personalizadas

Use la sobrecarga basada en coordenadas cuando necesite que los numeros de pagina aparezcan en una posicion X e Y especifica en cada pagina. Este enfoque es util cuando el diseno del documento requiere una ubicacion personalizada.

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

Agregar numeros de pagina con alineacion y margenes

Use la sobrecarga con argumentos de posicion y margen cuando necesite mas control sobre donde aparecen los numeros de pagina. En este ejemplo, los numeros se alinean en el area superior derecha de la pagina con margenes explicitos.

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

Agregar numeros de pagina con estilo romano

La funcion ‘add_page_numbers_with_roman_style’ muestra como mejorar un documento PDF agregando numeros de pagina con numeros romanos en mayusculas. Aprovecha la clase PdfFileStamp de Aspose.PDF para aplicar una numeracion coherente en todas las paginas.

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: Agregar sello a PDF

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

Aspose.PDF for Python via .NET proporciona la fachada PdfFileStamp para agregar contenido repetido a paginas PDF. Ademas de encabezados, pies de pagina y numeros de pagina, puede usarla para colocar sellos basados en texto en cada pagina de un documento.

Agregar el sello a un PDF

Despues de configurar el sello, enlace el PDF de entrada a PdfFileStamp, agregue el sello y guarde el archivo de salida. Esto aplica el sello configurado en todo el 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()