1. IronPDF
  2. Comment faire
  3. Arrière-plans et avant-plans

Comment ajouter un arrière-plan et un avant-plan superposé à des PDF ?

This article was translated from English: Does it need improvement?
Translated
View the article in English

par Chaknith Bin

L'ajout d'un arrière-plan permet d'insérer une image ou un autre document PDF comme couche d'arrière-plan derrière le contenu existant d'un PDF. Il est utile pour créer des en-têtes de lettres, des filigranes ou pour ajouter des éléments décoratifs à vos documents.

La superposition de l'avant-plan permet de placer du texte, des images ou d'autres contenus au-dessus d'un PDF existant, de manière à le superposer. Cette fonction est généralement utilisée pour ajouter des annotations, des tampons, des signatures ou des informations supplémentaires à un PDF sans modifier le contenu d'origine.

L'ajout d'un arrière-plan et l'incrustation d'un premier plan sont tous deux disponibles dans IronPDF avec les options d'utilisation du PDF comme arrière-plan et premier plan.

Comment ajouter un arrière-plan et un avant-plan superposé à des PDF ?

  1. Télécharger la bibliothèque C# pour ajouter un arrière-plan et superposer un premier plan
  2. Utiliser un PDF fraîchement rendu ou existant comme arrière-plan ou premier plan
  3. Utiliser le Ajouter un arrière-planPdf pour ajouter un arrière-plan
  4. Utiliser le AddForegroundOverlayPdf pour superposer un élément d'avant-plan
  5. Spécifier les pages auxquelles appliquer l'arrière-plan ou l'avant-plan


Bibliothèque NuGet C# pour PDF

Installer avec NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
ou
Java PDF JAR

Télécharger DLL

Télécharger la DLL

Installation manuelle dans votre projet

Bibliothèque NuGet C# pour PDF

Installer avec NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
ou
Java PDF JAR

Télécharger DLL

Télécharger la DLL

Installation manuelle dans votre projet

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer

Découvrez IronPDF sur NuGet pour une installation rapide et un déploiement facile. Avec plus de 8 millions de téléchargements, il transforme PDF avec C#.

Bibliothèque NuGet C# pour PDF nuget.org/packages/IronPdf/
Install-Package IronPdf

Envisagez d'installer le IronPDF DLL directement. Téléchargez et installez-le manuellement pour votre projet ou sous forme de GAC : {{lienDllAfficher}}

Installation manuelle dans votre projet

Télécharger la DLL

Ajouter un exemple d'arrière-plan

Utilisez la méthode AddBackgroundPdf pour ajouter un arrière-plan à un document PDF existant ou nouvellement rendu. L'exemple de code ci-dessous montre comment fournir à la méthode un objet PdfDocument. Cependant, vous pouvez également spécifier le chemin d'accès au fichier pour importer automatiquement le PDF et l'ajouter comme arrière-plan en une seule ligne de code.

Code

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add background
pdf.AddBackgroundPdf(background);

pdf.SaveAs("addBackground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Add background
pdf.AddBackgroundPdf(background)

pdf.SaveAs("addBackground.pdf")
VB   C#

Sortie PDF

Exemple d'incrustation à l'avant-plan

Comme pour l'ajout d'un arrière-plan, vous pouvez spécifier le chemin d'accès au fichier PDF pour importer le document et le superposer en avant-plan au PDF principal. Utilisez la méthode AddForegroundOverlayPdf pour superposer l'avant-plan au document PDF principal.

Code

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-foreground.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render foreground
PdfDocument foreground = renderer.RenderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 50%;'>Overlay Watermark</h1>");

// Overlay foreground
pdf.AddForegroundOverlayPdf(foreground);

pdf.SaveAs("overlayForeground.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render foreground
Private foreground As PdfDocument = renderer.RenderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 50%;'>Overlay Watermark</h1>")

' Overlay foreground
pdf.AddForegroundOverlayPdf(foreground)

pdf.SaveAs("overlayForeground.pdf")
VB   C#

Sortie PDF

Sélectionner des pages pour l'arrière-plan ou l'avant-plan

Il est possible de choisir la page du PDF à utiliser comme arrière-plan ou premier plan. Prenons l'exemple de l'application d'un arrière-plan, en utilisant un exemple de code similaire provenant de l'article 'Ajouter un exemple d'arrière-plan' section. Nous générons un PDF de deux pages avec une couleur différente pour l'arrière-plan. En spécifiant le chiffre 1 comme deuxième paramètre de la méthode AddBackgroundPdf, nous utilisons la deuxième page comme arrière-plan.

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

Code

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-background-page-2.cs
using IronPdf;

string backgroundHtml = @"
<div style = 'background-color: cyan; height: 100%;'></div>
<div style = 'page-break-after: always;'></div>
<div style = 'background-color: lemonchiffon; height: 100%;'></div>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf(backgroundHtml);

// Use page 2 as background
pdf.AddBackgroundPdf(background, 1);

pdf.SaveAs("addBackgroundFromPage2.pdf");
Imports IronPdf

Private backgroundHtml As String = "
<div style = 'background-color: cyan; height: 100%;'></div>
<div style = 'page-break-after: always;'></div>
<div style = 'background-color: lemonchiffon; height: 100%;'></div>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf(backgroundHtml)

' Use page 2 as background
pdf.AddBackgroundPdf(background, 1)

pdf.SaveAs("addBackgroundFromPage2.pdf")
VB   C#

Sortie PDF

Appliquer l'arrière-plan ou l'avant-plan aux pages spécifiées

Enfin, il est également possible d'appliquer un arrière-plan ou un premier plan à une seule page ou à plusieurs pages. Cette action nécessite l'utilisation d'un nom de méthode légèrement différent. Utilisez les méthodes AddBackgroundPdfToPage et AddForegroundOverlayPdfToPage pour ajouter respectivement un arrière-plan et un premier plan à une page particulière du PDF.

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

Postuler sur une seule page

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-single-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>");

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add background to page 1
pdf.AddBackgroundPdfToPage(0, background);

pdf.SaveAs("addBackgroundOnASinglePage.pdf");
Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Main HTML content</h1>")

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Add background to page 1
pdf.AddBackgroundPdfToPage(0, background)

pdf.SaveAs("addBackgroundOnASinglePage.pdf")
VB   C#

Utilisez les méthodes AddBackgroundPdfToPageRange et AddForegroundOverlayPdfToPageRange pour appliquer l'arrière-plan et l'avant-plan à plusieurs pages respectivement.

Appliquer sur plusieurs pages

:path=/static-assets/pdf/content-code-examples/how-to/background-foreground-multiple-pages.cs
using IronPdf;
using System.Collections.Generic;

string html = @"<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> This is 3rd Page</p>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Render background
PdfDocument background = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Create list of pages
List<int> pages = new List<int>() { 0, 2 };

// Add background to page 1 & 3
pdf.AddBackgroundPdfToPageRange(pages, background);

pdf.SaveAs("addBackgroundOnMultiplePage.pdf");
Imports IronPdf
Imports System.Collections.Generic

Private html As String = "<p> This is 1st Page </p>
<div style = 'page-break-after: always;'></div>
<p> This is 2nd Page</p>
<div style = 'page-break-after: always;'></div>
<p> This is 3rd Page</p>"

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Render background
Private background As PdfDocument = renderer.RenderHtmlAsPdf("<body style='background-color: cyan;'></body>")

' Create list of pages
Private pages As New List(Of Integer)() From {0, 2}

' Add background to page 1 & 3
pdf.AddBackgroundPdfToPageRange(pages, background)

pdf.SaveAs("addBackgroundOnMultiplePage.pdf")
VB   C#

Sortie PDF

Chaknith Bin

Ingénieur logiciel

Chaknith est le Sherlock Holmes des développeurs. C'est en s'amusant à relever des défis de code qu'il s'est rendu compte pour la première fois qu'il pourrait avoir un avenir dans le domaine de l'ingénierie logicielle. Il se concentre sur IronXL et IronBarcode, mais il est fier d'aider les clients avec chaque produit. Chaknith tire parti des connaissances qu'il a acquises en discutant directement avec les clients pour améliorer les produits eux-mêmes. Ses commentaires anecdotiques vont au-delà des tickets Jira et soutiennent le développement de produits, la documentation et le marketing, afin d'améliorer l'expérience globale des clients.Quand il n'est pas au bureau, on peut le trouver en train d'apprendre sur l'apprentissage automatique, le codage et la randonnée.