Stamp Text & Image on PDFs using C# and IronPDF

À quoi ressemble le PDF de sortie?

Comment créer des tampons de texte multilignes?

Utilisez la balise <br> pour le texte multiligne dans TextStamper. Par exemple, "ligne 1
ligne 2" produit "ligne 1" sur la première ligne et "ligne 2" sur la seconde. Cela permet de créer des tampons d'adresse ou des filigranes sur plusieurs lignes.

À quoi ressemble la sortie du tampon-image?

Quels sont les formats d'image pris en charge ?

ImageStamper prend en charge les formats PNG, JPEG, GIF et SVG à travers les références URI ou les chemins de fichiers. Veillez à ce que la connectivité réseau soit correcte pour les images à distance. Pour les environnements Azure, envisagez d'utiliser des images provenant d'Azure Blob Storage.

Qu'arrive-t-il lorsque les timbres se chevauchent?

Puis-je mélanger différents types de timbres ?

ApplyMultipleStamps accepte des tableaux contenant tout type de tampons. Combinez TextStamper, ImageStamper, HTMLStamper et BarcodeStamper en une seule opération. Créer des mises en page de documents complexes avec des en-têtes, des pieds de page, des filigranes et des codes d'identification simultanément.

Quelles sont les principales propriétés de positionnement ?

• HorizontalAlignment : Alignement horizontal par rapport à la page. Par défaut : HorizontalAlignment.Center.
• VerticalAlignment : Alignement vertical par rapport à la page. Par défaut : VerticalAlignment.Middle.
• HorizontalOffset : Décalage horizontal. Par défaut : 0, unité : MeasurementUnit.Percentage. Les valeurs positives sont décalées vers la droite, les valeurs négatives vers la gauche.
• VerticalOffset : Décalage vertical. Par défaut : 0, unité : MeasurementUnit.Percentage. Les valeurs positives sont décalées vers le bas, les valeurs négatives vers le haut.

Comment définir des décalages précis?

Spécifiez HorizontalOffset et VerticalOffset en utilisant la classe Length. L'unité de mesure par défaut est le pourcentage. Les unités disponibles sont les pouces, les millimètres, les centimètres, les pixels et les points. Cela permet un positionnement précis comme la définition de marges personnalisées dans les documents PDF.

Code

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-location.cs

using IronPdf.Editing;
using System;

// Create text stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};

Imports IronPdf.Editing
Imports System

' Create text stamper
Private imageStamper As New ImageStamper(New Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg")) With {
	.HorizontalAlignment = HorizontalAlignment.Center,
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalOffset = New Length(10),
	.VerticalOffset = New Length(10)
}

Ma bibliothèque préférée de ce genre est IronPDF. Elle permet une manipulation rapide et efficace des fichiers PDF. Elle dispose également de nombreuses fonctionnalités précieuses, comme l'exportation au format PDF/A et la signature numérique des documents PDF.

Milan Jovanovic

Microsoft MVP

Voir l'étude de cas

IronOCR signifie que nous pouvons économiser 40 000 $ par an grâce au traitement manuel, tout en améliorant la productivité et en libérant des ressources pour des tâches à fort impact. Je le recommande vivement.

Brent Matzelle

Directeur technique, OPYN

Voir l'étude de cas

Iron Suite joue un rôle crucial dans nos opérations. Ce sont des outils qui augmentent l'efficacité de l'entreprise, y compris la création de plans d'étage et l'amélioration de la gestion des stocks.

David Jones

Ingénieur logiciel principal, Agorus Build

Voir l'étude de cas

Code

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-multiple-stamps.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper[] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

pdf.SaveAs("multipleStamps.pdf");

Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")

' Create two text stampers
Private stamper1 As New TextStamper() With {
	.Text = "Text stamp 1",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Left
}

Private stamper2 As New TextStamper() With {
	.Text = "Text stamp 2",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Right
}

Private stampersToApply() As Stamper = { stamper1, stamper2 }

' Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply)

pdf.SaveAs("multipleStamps.pdf")

Quelles sont les propriétés essentielles de HTML Stamper?

• Html : Fragment HTML à tamponner sur votre PDF. Les références externes à JavaScript, CSS et images sont relatives à HtmlBaseUrl.
• HtmlBaseUrl : URL de base pour les références des fichiers CSS, JavaScript et images externes.
• CssMediaType : Active les styles CSS Media="screen". L'activation de AllowScreenCss=false rend les tampons en utilisant le média CSS="print". Par défaut : PdfCssMediaType.Screen.

Pourquoi utiliser HTML Stamper plutôt que Text Stamper?

HTMLStamper offre un support complet HTML et CSS pour des mises en page complexes, plusieurs polices, couleurs et images intégrées en un seul tampon. Idéal pour les filigranes de contenu riche ou d'en-têtes. Elle doit maintenir une image de marque cohérente et fonctionner avec des conceptions CSS réactives.

Code

:path=/static-assets/pdf/content-code-examples/how-to/stamp-text-image-stamp-text.cs

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

pdf.SaveAs("stampText.pdf");

Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")

' Create text stamper
Private textStamper As New TextStamper() With {
	.Text = "Text Stamper!",
	.FontFamily = "Bungee Spice",
	.UseGoogleFont = True,
	.FontSize = 30,
	.IsBold = True,
	.IsItalic = True,
	.VerticalAlignment = VerticalAlignment.Top
}

' Stamp the text stamper
pdf.ApplyStamp(textStamper)

pdf.SaveAs("stampText.pdf")

Quelles sont les options de configuration disponibles pour les BarCodes?

• Value : Valeur de la chaîne du code-barres.
• BarcodeType : Type d'encodage prenant en charge QRCode, Code128 et Code39. Par défaut : QRCode.
• Width : Largeur du code-barres rendu en pixels. Défaut : 250px.
• Height : Hauteur du code-barres rendu en pixels. Défaut : 250px.

Quand dois-je utiliser chaque type de BarCode?

QRCode gère les URL et les grands ensembles de données (jusqu'à 4 296 caractères alphanumériques). Code128 convient aux données alphanumériques avec des exigences de haute densité. Code39 fonctionne pour des combinaisons numériques simples ou de lettres majuscules. Tenez compte de la compatibilité de l'équipement de numérisation lors de la sélection des types de codes-barres.

Comment contrôler l'apparence des timbres ?

• Opacity : Contrôle de la transparence. 0 est invisible, 100 est opaque.
• Rotation : Fait tourner le tampon dans le sens horaire de 0 à 360 degrés.
• MaxWidth : Largeur maximale du tampon de sortie.
• MaxHeight : Hauteur maximale du tampon de sortie.
• MinWidth : Largeur minimale du tampon de sortie.
• MinHeight : Hauteur minimale du tampon de sortie.
• Hyperlink : Ajoute un hyperlien cliquable aux éléments tamponnés. Remarque : les liens HTML (balises a) ne sont pas préservés par l'estampillage.
• Scale : Applique une échelle en pourcentage aux tampons. Valeur par défaut : 100 (aucun effet).
• IsStampBehindContent : Place le tampon derrière le contenu. Le cachet peut être invisible si le contenu est opaque.
• WaitFor : Attend des événements ou un temps. Voir l'utilisation de WaitFor pour retarder le rendu PDF.
• Timeout : Délai d'attente de rendu en secondes. Valeur par défaut : 60.

Quelles sont les propriétés les plus couramment utilisées ?

Opacity et IsStampBehindContent créent des filigranes. Scale et Rotation ajustent le positionnement visuel et la taille. Exemple :

// Create a semi-transparent watermark behind content
TextStamper watermark = new TextStamper()
{
    Text = "CONFIDENTIAL",
    FontSize = 60,
    FontColorCode = "#CCCCCC",
    Opacity = 25,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center
};

// Create a semi-transparent watermark behind content
TextStamper watermark = new TextStamper()
{
    Text = "CONFIDENTIAL",
    FontSize = 60,
    FontColorCode = "#CCCCCC",
    Opacity = 25,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center
};

' Create a semi-transparent watermark behind content
Dim watermark As New TextStamper() With {
    .Text = "CONFIDENTIAL",
    .FontSize = 60,
    .FontColorCode = "#CCCCCC",
    .Opacity = 25,
    .Rotation = -45,
    .IsStampBehindContent = True,
    .VerticalAlignment = VerticalAlignment.Middle,
    .HorizontalAlignment = HorizontalAlignment.Center
}