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 via des références URI ou des 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 des tampons de tout type. 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. Valeur 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. Valeur 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),
};

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");

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

• Html: Fragment HTML à apposer sur votre PDF. Les références externes à JavaScript, CSS et images sont relatives à HtmlBaseUrl.
• HtmlBaseUrl: URL de base pour les références de fichiers CSS, JavaScript et image externes.
• CssMediaType: Active les styles CSS Media="screen". Le paramètre AllowScreenCss=false affiche les timbres en utilisant CSS media="print". Par défaut : PdfCssMediaType.Screen.

Pourquoi utiliser HTML Stamper plutôt que Text Stamper?

HTMLStamper offre une prise en charge complète du HTML et du CSS pour les mises en page complexes, les polices multiples, les couleurs et les images intégrées dans un seul tampon. Idéal pour les filigranes ou les en-têtes riches en contenu. 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");

Quelles sont les options de configuration disponibles pour les BarCodes?

• Value: Valeur de chaîne du code-barres.
• BarcodeType: Type d'encodage prenant en charge QRCode, Code128 et Code39. Valeur 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 les combinaisons simples de chiffres 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 la transparence. 0 est invisible, 100 est opaque.
• Rotation: Fait pivoter le tampon dans le sens horaire de 0 à 360 degrés.
• MaxWidth: Largeur maximale du tampon de sortie.
• MaxHeight: Hauteur maximale du timbre de sortie.
• MinWidth: Largeur minimale du tampon de sortie.
• MinHeight: Hauteur minimale du timbre de sortie.
• Hyperlink: Ajoute un lien hypertexte au clic sur les éléments estampillés. Remarque : les liens HTML (balises a) ne sont pas préservés par l'estampillage.
• Scale: Applique une échelle de pourcentage aux timbres. 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 du 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 et la taille visuels. 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
};