Hinzufügen von Hintergrund und Überlagerung des Vordergrunds in PDFs

Chaknith Bin

9. Oktober 2023

Aktualisiert 5. Februar 2025

Teilen Sie:

Translated

View the article in English

Mit der Funktion "Hintergrund hinzufügen" können Sie ein Bild oder ein anderes PDF-Dokument als Hintergrundebene hinter den vorhandenen Inhalt einer PDF-Datei einfügen. Es ist nützlich für die Erstellung von Briefköpfen, Wasserzeichen oder das Hinzufügen von dekorativen Elementen zu Ihren Dokumenten.

Mit der Funktion "Vordergrund überlagern" können Sie Text, Bilder oder andere Inhalte über einer vorhandenen PDF-Datei platzieren und diese sozusagen überlagern. Diese Funktion wird häufig verwendet, um Anmerkungen, Stempel, Unterschriften oder zusätzliche Informationen zu einer PDF-Datei hinzuzufügen, ohne den ursprünglichen Inhalt zu verändern.

IronPDF bietet die Möglichkeit, einen Hintergrund hinzuzufügen und den Vordergrund zu überlagern, wobei die PDF-Datei als Hintergrund und als Vordergrund verwendet werden kann.

Erste Schritte mit IronPDF

Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.

Erster Schritt:

Hinzufügen von Hintergrund und Überlagerung des Vordergrunds in PDFs

IronPDF-Bibliothek von NuGet herunterladen
Verwenden Sie eine frisch gerenderte oder vorhandene PDF-Datei als Hintergrund oder Vordergrund
Verwenden Sie die AddBackgroundPdf-Methode, um einen Hintergrund hinzuzufügen
Verwenden Sie die AddForegroundOverlayPdf-Methode, um ein Vordergrund-Overlay hinzuzufügen
Angeben, auf welchen Seiten der Hintergrund oder Vordergrund angewendet werden soll

Hintergrund hinzufügen Beispiel

Nutzen Sie die AddBackgroundPdf-Methode, um einem neu gerenderten oder bestehenden PDF-Dokument einen Hintergrund hinzuzufügen. Das folgende Codebeispiel zeigt, wie die Methode mit einem PdfDocument-Objekt bereitgestellt wird. Sie können jedoch auch den Dateipfad angeben, um die PDF-Datei automatisch zu importieren und sie in einer einzigen Codezeile als Hintergrund hinzuzufügen.

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

$vbLabelText $csharpLabel

Ausgabe PDF

Beispiel für Überlagerung des Vordergrunds

Ähnlich wie beim Hinzufügen eines Hintergrunds können Sie den Pfad der PDF-Datei angeben, um das Dokument zu importieren und es als Vordergrund über die Haupt-PDF-Datei zu legen. Verwenden Sie die AddForegroundOverlayPdf-Methode, um den Vordergrund auf das Haupt-PDF-Dokument zu überlagern.

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

$vbLabelText $csharpLabel

Ausgabe PDF

Seiten für Hintergrund oder Vordergrund auswählen

Es ist möglich zu wählen, welche Seite der PDF-Datei als Hintergrund oder Vordergrund verwendet werden soll. Als Beispiel nehmen wir das Anwenden eines Hintergrunds, indem wir ein ähnliches Codebeispiel aus dem Abschnitt 'Beispiel für das Hinzufügen eines Hintergrunds' verwenden. Wir erstellen eine zweiseitige PDF-Datei mit einer anderen Farbe als Hintergrund. Indem wir die Zahl 1 als zweiten Parameter in der AddBackgroundPdf-Methode angeben, verwenden wir die 2. Seite als Hintergrund.

Tipps

Alle Seitenindizes folgen einer nullbasierten Indizierung.

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

$vbLabelText $csharpLabel

Ausgabe PDF

Hintergrund oder Vordergrund auf bestimmte Seiten anwenden

Schließlich ist es auch möglich, den Hintergrund oder den Vordergrund auf eine einzelne Seite oder mehrere Seiten anzuwenden. Für diese Aktion muss ein etwas anderer Methodenname verwendet werden. Verwenden Sie die Methoden AddBackgroundPdfToPage und AddForegroundOverlayPdfToPage, um Hintergrund und Vordergrundüberlagerung zu einer bestimmten Seite des PDFs hinzuzufügen.

Tipps

Alle Seitenindizes folgen einer nullbasierten Indizierung.

Bewerbung auf einer einzigen Seite

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

$vbLabelText $csharpLabel

Verwenden Sie die Methoden AddBackgroundPdfToPageRange und AddForegroundOverlayPdfToPageRange, um Hintergrund und Vordergrund auf mehrere Seiten anzuwenden.

Auf mehrere Seiten anwenden

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

$vbLabelText $csharpLabel

Ausgabe PDF

Chaknith Bin

Jetzt mit dem Ingenieurteam chatten

Software-Ingenieur

Chaknith ist der Sherlock Holmes der Entwickler. Zum ersten Mal kam ihm der Gedanke, dass er eine Zukunft in der Softwareentwicklung haben könnte, als er zum Spaß an Code Challenges teilnahm. Sein Schwerpunkt liegt auf IronXL und IronBarcode, aber er ist stolz darauf, Kunden mit jedem Produkt zu helfen. Chaknith nutzt sein Wissen aus direkten Gesprächen mit Kunden, um die Produkte selbst weiter zu verbessern. Sein anekdotisches Feedback geht über Jira-Tickets hinaus und unterstützt die Produktentwicklung, die Dokumentation und das Marketing, um das Gesamterlebnis der Kunden zu verbessern.Wenn er nicht im Büro ist, lernt er über maschinelles Lernen, programmiert und wandert.