UTILISATION D'IRONPDF

Comment ajouter un estampilleur de PDF en C#

Mise à jour mars 24, 2024
Partager:

L'ajout de texte et d'images à un PDF consiste à superposer du contenu supplémentaire à un document PDF existant. Ce contenu, souvent appelé "timbre", peut être du texte, des images ou une combinaison des deux. En général, les utilisateurs ajoutent des informations, des étiquettes, des filigranes ou des annotations à un PDF à l'aide de tampons.

IronPDF offre une solution conviviale et polyvalente pour personnaliser le contenu des PDF afin de répondre à différents besoins. La classe abstraite Stamper est un élément clé des méthodes d'estampillage d'IronPDF, pour une gamme de classes d'estampillage spécialisées, chacune conçue à des fins spécifiques.

  1. TextStamper : Le TextStamper est votre solution pour ajouter du texte descriptif aux PDF. Qu'il s'agisse d'améliorer un document existant, de placer du texte sur la même page ou d'incorporer des détails provenant d'autres documents PDF, cette estampeuse vous permet de personnaliser vos fichiers en y ajoutant des descriptions et des informations.
  2. ImageStamper : ImageStamper est l'outil idéal pour placer des images dans vos PDF. Qu'il s'agisse d'un logo pour la description d'un fichier, d'une illustration pour un document existant ou d'un élément visuel pour la même page ou un autre document PDF, cette estampe assure une intégration transparente des images.
  3. HtmlStamper : Le HtmlStamper porte la personnalisation à un niveau supérieur, en vous permettant d'apposer du contenu HTML sur vos PDF. Il s'agit notamment de créer des éléments dynamiques tels que du contenu interactif, des descriptions et des spécifications de fichiers, ce qui offre une flexibilité qui va au-delà de la personnalisation traditionnelle des PDF.
  4. BarcodeStamper pour tamponner les codes-barres : Le BarcodeStamper simplifie le processus d'ajout de codes-barres à vos PDF. Que ce soit à des fins de suivi dans un document signé, un fichier temporaire ou une pièce jointe, cette estampe garantit une intégration efficace des codes-barres dans vos PDF.
  5. BarcodeStamper pour tamponner les QR Codes : BarcodeStamper est spécialisé dans l'apposition de codes QR sur vos PDF. Parfaite pour créer du contenu interactif ou des pièces jointes, cette estampe vous permet d'intégrer des codes QR sur la même page ou sur d'autres documents PDF, garantissant ainsi un accès facile à des informations supplémentaires.

    Ces classes d'estampage spécialisées permettent aux utilisateurs d'enrichir facilement les documents PDF avec divers éléments, du texte de base aux conceptions HTML complexes et aux codes-barres dynamiques. Cet article explore les fonctionnalités des trois principaux tamponneurs : TextStamper, ImageStamperet HTMLStamper. HTMLStamper est particulièrement puissant parce qu'il peut utiliser toutes les fonctionnalités HTML, associées au style CSS, ce qui ajoute une couche supplémentaire de polyvalence au processus d'estampillage.

Comment estampiller du texte et des images sur des PDF

  1. Téléchargez la bibliothèque C# pour tamponner du texte et des images.
  2. Créer et configurer la classe d'estampage souhaitée.
  3. Utilisez la méthode "ApplyStamp" pour appliquer le cachet au PDF.
  4. Appliquez plusieurs tampons à l'aide de la méthode "ApplyMultipleStamps".
  5. Spécifiez les pages auxquelles les timbres doivent être appliqués.

Configuration et application de tampons de texte dans les PDF

Tout d'abord, créez un objet de la classe TextStamper pour prendre en charge l'estampillage de texte dans les PDF. L'objet de cette classe contient toutes les configurations permettant de spécifier la manière dont l'estampilleur de texte est présenté. Transmettre l'objet textStamper à la méthode "ApplyStamp". La propriété Texte définit le contenu à afficher sur le PDF.

De plus, il est possible de spécifier la famille de police, le style de police, ainsi que l'emplacement du tampon. Cette personnalisation s'étend aux éléments interactifs, aux descriptions de fichiers et au contenu existant sur le même PDF ou sur d'autres PDF. Ensuite, exportez le PDF avec le nom de fichier actuel.

Une fois les configurations terminées, exportez le fichier PDF de sortie avec le nom de fichier désigné, en encapsulant tous les paramètres et en donnant une touche professionnelle à vos documents.

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");
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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Configurer et appliquer des tampons d'image dans le PDF

Comme pour le texte, créez un objet à partir de la classe ImageStamper, puis utilisez la fonction ApplyStamp pour appliquer l'image au document. Le deuxième paramètre de cette méthode contient également un index de page, ce qui permet d'appliquer le cachet à une ou plusieurs pages. Cette instance spécifique peut demander au système d'appliquer l'image en tant que tampon, en particulier sur la première page du PDF.

Tous les index de pages suivent l'indexation à base zéro.

using IronPdf;
using IronPdf.Editing;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");
// Create image stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};
// Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0);
pdf.SaveAs("stampImage.pdf");
using IronPdf;
using IronPdf.Editing;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");
// Create image stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};
// Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0);
pdf.SaveAs("stampImage.pdf");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Appliquer plusieurs tampons

Pour ajouter plusieurs tampons à un document, utilisez la fonction ApplyMultipleStamps (Appliquer des timbres multiples) d'IronPDF en lui transmettant un tableau de tampons. Il vous permet d'ajouter différents éléments, tels que du texte, des images ou des étiquettes, en une seule fois. Dans cet exemple, deux tampons ont été créés avec des textes et des alignements différents. La commande pdf.ApplyMultipleStamps applique les deux tampons au PDF, et le document final est enregistré sous le nom multipleStamps.pdf. Cette méthode rationalise le processus d'ajout de divers tampons et offre un moyen pratique d'agrémenter votre PDF de plusieurs éléments, que ce soit sur la même page, sur un autre PDF ou même sur une page vierge.

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");
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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
VB   C#

Spécification de l'emplacement du tampon sur le document PDF

Pour définir l'emplacement du timbre, utilisez une grille de 3x3 avec trois colonnes horizontales et trois lignes verticales. Vous avez le choix entre un alignement horizontal à gauche, au centre et à droite, et un alignement vertical : en haut, au milieu et en bas. Vous pouvez ajuster les décalages horizontaux et verticaux pour plus de précision pour chaque position. L'image ci-dessous donne une représentation visuelle de ce concept.

Comment ajouter un estampilleur de PDF en C#, Figure 1 : Positionnement de l'estampilleur de PDF Positionnement de l'estampilleur de PDF

  • HorizontalAlignment : L'alignement horizontal du timbre par rapport à la page.
  • VerticalAlignment : L'alignement vertical du timbre par rapport à la page.
  • HorizontalOffset : Le décalage horizontal. La valeur par défaut est 0, et l'unité par défaut est IronPDF.Editing.MeasurementUnit.Percentage. Les valeurs positives indiquent un décalage vers la droite, tandis que les valeurs négatives indiquent un décalage vers la gauche.
  • VerticalOffset : Le décalage vertical. La valeur par défaut est 0, et l'unité par défaut est IronPDF.Editing.MeasurementUnit.Percentage. Les valeurs positives indiquent un décalage vers le bas, tandis que les valeurs négatives indiquent un décalage vers le haut.

    Pour spécifier les propriétés HorizontalOffset et VerticalOffset, instanciez la propriété Longueur classe. L'unité de mesure par défaut de Length est le pourcentage, mais elle peut également utiliser des unités de mesure telles que les pouces, les millimètres, les centimètres, les pixels et les points.

using IronPdf.Editing;
// 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),
};
using IronPdf.Editing;
// 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
' 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)
}
VB   C#

Configuration et application des tampons HTML dans le PDF

Il existe une autre classe de tampons qui peut être utilisée pour tamponner à la fois du texte et des images. Les HtmlStamper class peut rendre des dessins HTML avec un style CSS et les imprimer sur le document PDF. La propriété InnerHtmlBaseUrl est utilisée pour spécifier l'URL de base des ressources de la chaîne HTML, telles que les fichiers CSS et les images.

La classe HtmlStamper est appliquée au PDF. Cet objet d'estampage comprend une image et un texte, que vous pouvez définir dans le fragment HTML à estampiller sur votre PDF. Toutes les références externes aux fichiers JavaScript, CSS et images seront relatives à la propriété Html intérieure. Ce code vous permet de personnaliser le PDF en fonction de spécifications de fichiers spécifiques mentionnées dans le contenu HTML. Enfin, le PDF modifié est enregistré sous le nom de fichier "stampHtml.pdf"

using IronPdf;
using IronPdf.Editing;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");
// Create HTML stamper
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};
// Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper);
pdf.SaveAs("stampHtml.pdf");
using IronPdf;
using IronPdf.Editing;
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");
// Create HTML stamper
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};
// Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper);
pdf.SaveAs("stampHtml.pdf");
Imports IronPdf
Imports IronPdf.Editing
Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")
' Create HTML stamper
Private htmlStamper As New HtmlStamper() With {
	.Html = "<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
	.VerticalAlignment = VerticalAlignment.Top
}
' Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper)
pdf.SaveAs("stampHtml.pdf")
VB   C#

Options HTML Stamper

Outre les options mentionnées et expliquées ci-dessus, d'autres options sont disponibles pour les classes d'estampeurs.

  • Opacité : Permet au tampon d'être transparent. 0 est totalement invisible, et 100 est totalement opaque.
  • Rotation : Fait pivoter le timbre dans le sens des aiguilles d'une montre de 0 à 360 degrés, comme spécifié.
  • MaxWidth : Largeur maximale du timbre de sortie.
  • MaxHeight : La hauteur maximale du timbre de sortie.
  • MinWidth : Largeur minimale du timbre de sortie.
  • MinHeight : La hauteur minimale du timbre de sortie.
  • Lien hypertexte : Permet aux éléments estampillés de ce Stamper d'avoir un lien hypertexte au clic. Note : Les liens HTML créés par link(a) ne sont pas réservées par l'estampillage.
  • Échelle : Applique une échelle de pourcentage aux timbres pour les agrandir ou les réduire. La valeur par défaut est 100 (Pourcentage)qui n'a aucun effet.
  • IsStampBehindContent : La valeur "true" permet d'appliquer le timbre derrière le contenu. Si le contenu est opaque, le cachet peut être invisible.
  • WaitFor : Une enveloppe pratique pour attendre divers événements ou un certain temps.
  • Timeout : Délai de rendu en secondes. La valeur par défaut est 60.

    Les options d'estampage d'IronPDF offrent une personnalisation avancée, permettant aux utilisateurs d'améliorer les PDF avec de la transparence, une rotation précise et des dimensions contrôlées. Des fonctions telles que Hyperlink et Scale facilitent l'incorporation de tous les éléments interactifs, tout en respectant les spécifications des fichiers et en mettant l'accent sur le contenu. L'option IsStampBehindContent positionne stratégiquement les tampons, en s'assurant qu'ils font partie du même objet, et non des champs. Parallèlement, la fonction WaitFor gère efficacement les événements de rendu, ce qui fait d'IronPDF un outil polyvalent pour la personnalisation des PDF, y compris la rotation originale des pages.

Conclusion

En conclusion, L'estampilleur d'IronPDF offre une solution polyvalente et conviviale pour améliorer les documents PDF. Qu'il s'agisse d'ajouter de simples étiquettes de texte, d'incorporer des images ou de tirer parti de la puissance du HTML et du CSS avec le HTMLStamper, IronPDF répond à un large éventail de besoins de personnalisation.

La facilité d'utilisation et les exemples pratiques illustrant l'application de tampons de texte et d'image le rendent accessible aux utilisateurs ayant des compétences techniques variées. Les options de marquage, notamment l'opacité, la rotation et l'échelle, constituent une boîte à outils complète pour les utilisateurs désireux de personnaliser les PDF sans effort. La fonction d'estampage d'IronPDF s'impose comme un outil fiable et efficace, permettant aux utilisateurs de rehausser facilement leurs documents PDF.

Essentiellement, IronPDF élève sans effort les PDF pour les besoins de base et avancés, y compris l'extraction de textes et d'images intégrés, traitement des formulaires PDF, fusionner ou diviser des fichiers PDFet de formater les fichiers PDF à l'aide de en-têtes et pieds de page personnalisés de manière programmatique. Pour les demandes de renseignements ou de fonctionnalités, notre équipe de soutien est prêt à apporter son aide.

< PRÉCÉDENT
Comment convertir un fichier PDF en fichier Tiff dans .NET
SUIVANT >
Comment lire des fichiers PDF en C#