Documentation – Classe PdfFileStamp

Python-Net: Ajouter un pied de page au PDF

Fri, 22 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fournit le PdfFileStamp façade pour ajouter du contenu répété aux pages PDF. Vous pouvez l’utiliser pour placer du texte de pied de page ou des images au bas de chaque page et ajuster les marges du pied de page pour contrôler le positionnement.

Ajouter un texte de pied de page

Utiliser add_footer() avec un FormattedText objet lorsque vous voulez placer le même texte de pied de page sur chaque page du PDF. Le deuxième argument définit la marge inférieure utilisée pour le placement du pied de page.

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

Ajouter un pied de page d’image

Utiliser add_footer() avec un flux d’image lorsque le pied de page doit afficher un logo ou une autre image au lieu du texte. L’exemple ouvre le fichier image en tant que flux binaire et le place en bas de chaque page.

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

Ajouter un pied de page avec des marges personnalisées

Utilisez la surcharge avec trois valeurs de marge lorsque vous avez besoin de plus de contrôle sur le positionnement du pied de page. Dans cet exemple, le pied de page est ajouté avec des marges personnalisées en bas, à gauche et à droite.

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: Ajouter un en-tête au PDF

Fri, 22 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fournit le PdfFileStamp façade pour ajouter du contenu répété aux pages PDF. Vous pouvez l’utiliser pour placer du texte d’en‑tête ou des images en haut de chaque page et ajuster les marges d’en‑tête pour contrôler le placement.

Ajouter un en‑tête texte

Utiliser add_header() avec un FormattedText objet lorsque vous souhaitez placer le même texte d’en-tête sur chaque page du PDF. Le deuxième argument définit la marge supérieure de l’en-tête.

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

Ajouter un en‑tête d’image

Utiliser add_header() avec un fichier d’image ou un flux d’image lorsque l’en-tête doit afficher un logo ou un autre graphique. Cela est utile pour les mises en page de documents de marque.

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

Ajouter un en-tête avec des marges personnalisées

Utilisez la surcharge avec trois valeurs de marge lorsque vous avez besoin de plus de contrôle sur le placement de l’en-tête. Dans cet exemple, l’en-tête est ajouté avec les marges supérieures, gauche et droite personnalisées.

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: Ajouter le numéro de page au PDF

Fri, 22 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fournit le PdfFileStamp façade pour ajouter du contenu répété aux pages PDF. Vous pouvez l’utiliser pour insérer des numéros de page avec un placement par défaut, les positionner à des coordonnées spécifiques, ou contrôler leur alignement et leurs marges.

Ajouter des numéros de page avec le placement par défaut

Utiliser add_page_number() sans arguments de position supplémentaires lorsque vous souhaitez que les numéros de page soient ajoutés à l’emplacement par défaut. C’est la façon la plus simple de numéroter chaque page du document.

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

Ajouter des numéros de page à des coordonnées personnalisées

Utilisez la surcharge basée sur les coordonnées lorsque vous avez besoin que les numéros de page apparaissent à une position X et Y spécifiques sur chaque page. Cette approche est utile lorsque la mise en page du document nécessite un placement personnalisé.

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

Ajouter des numéros de page avec alignement et marges

Utilisez la surcharge avec les arguments de position et de marge lorsque vous avez besoin de plus de contrôle sur l’emplacement des numéros de page. Dans cet exemple, les numéros sont alignés dans la zone supérieure droite de la page avec des marges explicites.

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

Ajouter des numéros de page au style romain

La fonction ‘add_page_numbers_with_roman_style’ montre comment améliorer un document PDF en ajoutant des numéros de page utilisant des chiffres romains majuscules. Elle exploite la classe PdfFileStamp d’Aspose.PDF pour appliquer une numérotation cohérente sur toutes les pages.

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: Ajouter un tampon au PDF

Fri, 22 May 2026 00:00:00 +0000

Aspose.PDF for Python via .NET fournit le PdfFileStamp façade pour ajouter du contenu récurrent aux pages PDF. En plus des en-têtes, pieds de page et numéros de page, vous pouvez l’utiliser pour placer des tampons basés sur du texte sur chaque document.

Ajouter le tampon à un PDF

Après la configuration du tampon, liez le PDF d’entrée à PdfFileStamp, ajouter le tampon, et enregistrer le fichier de sortie. Cela applique le tampon configuré sur l’ensemble du document.

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