Wie man in Java Hintergrund und Overlay-Vordergrund zu PDFs hinzufügt

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

von Mehr Muhammad Hamza

Das Hinzufügen eines Hintergrunds zu einer PDF-Datei ermöglicht es, ein Bild oder ein anderes PDF-Dokument hinter den Inhalt einer bestehenden PDF-Datei einzufügen und sie mit Elementen wie Briefköpfen, Wasserzeichen oder Designelementen zu erweitern. Das Überlagern eines Vordergrunds ermöglicht es Ihnen, zusätzlichen Inhalt wie Anmerkungen, Stempel oder Unterschriften auf dem PDF zu platzieren.

IronPDF for Java bietet einfache Methoden, um beides zu erreichen. Sie können ein gerendertes oder vorhandenes PDF als Hintergrund- oder Vordergrund-Overlay verwenden, mit der Flexibilität, Änderungen auf alle Seiten oder bestimmte Seiten anzuwenden. In diesem Leitfaden zeigen wir, wie man mit IronPDF in Java Hintergründe hinzufügt und Vordergründe überlagert.

Hintergrund zu einer PDF hinzufügen

Um einem vorhandenen oder neu erstellten PDF-Dokument einen Hintergrund hinzuzufügen, verwenden Sie die Methode addBackgroundPdf. Dieses Beispiel zeigt, wie man ein PDF importiert, einen Hintergrund rendert und den Hintergrund auf das PDF anwendet.

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load the background PDF
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add the background to all pages
pdf.addBackgroundPdf(background);

// Save the modified PDF
pdf.saveAs(Paths.get("addBackground.pdf"));
JAVA

Ausgabe PDF

Die generierte PDF-Ausgabedatei ist wie folgt:

Hintergrund zu bestimmten Seiten hinzufügen

Mit der gleichen addBackgroundPdf-Methode können Sie auch einen Hintergrund zu beliebigen ausgewählten Seiten hinzufügen. Dies ist nützlich, um benutzerdefinierte Designs anzuwenden, wie z.B. eine Titelseite oder ein spezifisches Markenlayout. Die PageSelection-Klasse ist erforderlich und enthält mehrere nützliche Methoden, wie allPages, singlePage, pageRange und mehr.

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;

// Load the PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load the background PDF
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Add background only to the first page of the target PDF
// The second parameter (0) refers to the first page of the background PDF
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

// Save the modified PDF
pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
JAVA

Der Parameter backgroundPdfPageIndex legt fest, welche Seite des Hintergrund-PDFs als Hintergrundseite verwendet werden soll. Dieser Parameter verwendet einen nullbasierten Index, um die Seite anzugeben, die aus dem Hintergrund/Vordergrund-PDF kopiert werden soll, wobei der Standardwert auf 0 gesetzt ist.


Vordergrund zu einer PDF hinzufügen

Die Methode addForegroundPdf kann verwendet werden, um Inhalte über die vorhandenen Seiten in einem PDF zu legen. Dies ist nützlich, um Elemente wie Wasserzeichen oder andere visuelle Indikatoren hinzuzufügen. Ähnlich wie im Hintergrundabschnitt werden wir den Vordergrund rendern und ihn auf das PDF-Dokument anwenden.

import com.ironsoftware.ironpdf.*;

License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Create the foreground PDF using HTML content
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>");

// Add the foreground to all pages
pdf.addForegroundPdf(foreground);

// Save the modified PDF
pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

Ausgabe

Die PDF-Ausgabedatei ist als:

Vordergrund zu bestimmten Seiten hinzufügen

Sie können den Vordergrund auf einen bestimmten Seitenbereich mithilfe der Methode PageSelection.pageRange überlagern. So können Sie den Vordergrund auf die Seiten 2 bis 8 anwenden.

import com.ironsoftware.ironpdf.*;
import com.ironsoftware.ironpdf.edit.PageSelection;

// Load the PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Create the foreground PDF using HTML content
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>");

// Add the foreground to a specific page range (from page 2 to page 8)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

// Save the modified PDF
pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

Erkunden Sie die PageSelection-Klasse

Beim Arbeiten mit Vorder- und Hintergründen bietet IronPDF flexible Möglichkeiten, um die Seiten anzugeben, auf denen sie angewendet werden sollen, indem die Methoden in der PageSelection-Klasse verwendet werden. Hier sind die Optionen:

  • ersteSeite(): Wendet die Änderung auf die erste Seite des PDFs an.
  • `letzteSeite(): Wendet die Änderung auf die letzte Seite des PDFs an.
  • Einzelseite(int-Index): Zielt auf eine bestimmte Seite basierend auf ihrem Index ab(ausgehend von 0).
  • Seitenbereich(int startIndex, int endIndex): Zielt auf einen Bereich von Seiten von startIndex bis endIndex ab(inklusive).
  • `Seitenbereich(ListeSeitenlistee): Wendet Änderungen auf eine Liste bestimmter Seiten an und ermöglicht die Auswahl nicht-sequenzieller Seiten.