1. IronPDF
  2. Anleitungen
  3. Hintergründe & Vordergründe

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

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

von Chaknith Bin

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:
green arrow pointer

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

  1. IronPDF-Bibliothek von NuGet herunterladen
  2. Verwenden Sie eine frisch gerenderte oder vorhandene PDF-Datei als Hintergrund oder Vordergrund
  3. Verwenden Sie die AddBackgroundPdf methode zum Hinzufügen eines Hintergrunds
  4. Verwenden Sie die AddForegroundOverlayPdf methode zum Überlagern eines Vordergrunds
  5. Legen Sie fest, auf welche Seiten der Hintergrund oder der Vordergrund angewendet werden soll


Hintergrund hinzufügen Beispiel

Verwenden Sie die Methode AddBackgroundPdf, um einen Hintergrund zu einem neu gerenderten oder bestehenden PDF-Dokument 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")
VB   C#

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 Methode AddForegroundOverlayPdf, um den Vordergrund über das Haupt-PDF-Dokument zu legen.

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#

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. Nehmen wir das Aufbringen eines Hintergrunds als Beispiel, wobei wir ein ähnliches Codebeispiel aus dem 'Hintergrund hinzufügen Beispiel' Abschnitt. Wir erstellen eine zweiseitige PDF-Datei mit einer anderen Farbe als Hintergrund. Durch die Angabe der Zahl 1 als zweiten Parameter in der Methode AddBackgroundPdf wird die zweite Seite als Hintergrund verwendet.

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")
VB   C#

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 einer einzelnen Seite der PDF-Datei einen Hintergrund hinzuzufügen bzw. den Vordergrund zu überlagern.

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")
VB   C#

Verwenden Sie die Methoden AddBackgroundPdfToPageRange und AddForegroundOverlayPdfToPageRange, um Hintergrund bzw. 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")
VB   C#

Ausgabe PDF

Chaknith related to Ausgabe PDF

Chaknith Bin

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.