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

Hintergrund und überlagernder Vordergrund in PDFs in Java

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

IronPDF for Java bietet die Methodeen addBackgroundPdf und addForegroundPdf, mit denen zusätzliche PDF-Inhalte entweder hinter oder über bestehende Seiten platziert werden können. Diese Methodeen decken das gesamte Spektrum praktischer Overlay-Szenarien ab: Briefköpfe, Farbinfüllungen, Wasserzeichen, Zustimmungstempel und Revisionsindikatoren. Die Bibliothek rendert HTML intern zu PDF, sodass jeder gültige CSS-Ausdruck (Verläufe, Bilder, Typografie) ohne manuelle PDF-Stream-Manipulation zu einer Hintergrund- oder Vordergrundebene werden kann.

Fügen Sie IronPDF zu Ihrem Projekt hinzu, indem Sie die Abhängigkeit in pom.xml über Maven Central deklarieren, und aktivieren Sie anschließend Ihren Lizenzschlüssel, bevor Sie API-Aufrufe durchführen.

Schnellstart: Hintergrund und Vordergrund zu PDFs hinzufügen

```java :title=Schnellstart //:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/quickstart.java import com.ironsoftware.ironPdf.*; import com.ironsoftware.ironPdf.edit.PageSelection; import java.nio.file.Paths;

// Laden Sie das Ziel-PDF PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));

// Rendern Sie einen Hintergrund aus HTML und wenden Sie ihn auf alle Seiten an PdfDocument background = PdfDocument.renderHtmlAsPdf(""); pdf.addBackgroundPDF(background);

// Rendern Sie ein Vordergrund-Overlay und wenden Sie es auf alle Seiten an PdfDocument foreground = PdfDocument.renderHtmlAsPdf(""); pdf.addForegroundPDF(foreground);

pdf.saveAs(Paths.get("output.pdf"));


<div class="hsg-featured-snippet">
<h3>Minimaler Arbeitsablauf (5 Schritte)</h3>
  <ol>
    <li><a class="js-modal-open" data-modal-id="download-modal" href="#download-modal">Installieren Sie die IronPDF Java-Bibliothek über Maven</a></li>
    <li>Laden Sie das Ziel-PDF mit <code>PdfDocument.fromFile()</code></li>
    <li>Rendern oder importieren Sie den Hintergrund oder das Vordergrund-PDF</li>
    <li>Rufen Sie <code>addBackgroundPdf</code> auf, um Inhalte hinter bestehenden Seiten zu schichten</li>
    <li>Rufen Sie <code>addForegroundPdf</code> auf, um Inhalte über bestehenden Seiten zu überlagern</li>
  </ol>
</div>

## Wie füge ich einem PDF einen Hintergrund hinzu?

Um einem bestehenden PDF einen Hintergrund hinzuzufügen, rufen Sie `addBackgroundPdf` auf einer `PdfDocument`-Instanz auf und übergeben Sie ein zweites `PdfDocument` als Hintergrundquelle. Die Methodee komponiert den Hintergrund unter jede Seite des Zieldokuments. Bevor Sie den Code ausführen, [richten Sie IronPDF mit Ihrem Lizenzschlüssel ein](https://ironpdf.com/java/get-started/license-keys/), um die Bibliothek zu aktivieren.

```java
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a background from an HTML color definition
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Apply the background to all pages
pdf.addBackgroundPDF(background);

pdf.saveAs(Paths.get("addBackground.pdf"));

Der Aufruf renderHtmlAsPdf wandelt jeglichen gültigen HTML- und CSS-Code in eine PDF-Seite um, die IronPDF hinter Ihren bestehenden Inhalten einfügt. Sie können benutzerdefiniertes CSS-Styling im HTML-zu-PDF-Tutorial verwenden, um Farbverläufe, sich wiederholende Muster oder bildbasierte Hintergründe zu erzeugen. Der HTML-Rendering-Engine verarbeitet moderne CSS-Eigenschaften, sodass Designs, die in einem Browser funktionieren, direkt in die Hintergrundebene übersetzt werden.

TippsVerwenden Sie <body style='margin:0; padding:0;'> in Ihrer HTML-Hintergrundvorlage, um Standard-Browser-Ränder zu eliminieren und sicherzustellen, dass die Farbe oder das Bild die gesamte Seite füllt.

Wie sieht das Ausgabe-PDF mit Hintergrund aus?

Warum HTML verwenden, um PDF-Hintergründe zu erstellen?

Das Hinzufügen eines Hintergrunds schichtet ein Bild oder eine Dokumentseite hinter bestehenden Inhalt und ermöglicht Briefköpfe, Farbinfüllungen, Wasserzeichen und dekorative Designelemente. Das Überlagern eines Vordergrunds platziert Inhalte darüber und ist nützlich für Anmerkungen, Stempel und Genehmigungsindikatoren.

Der HTML-basierte Ansatz bietet mehrere konkrete Vorteile gegenüber Bildimporten:

  • Präzise CSS-Steuerung: Verwenden Sie jede CSS-Farbe, -Verlauf, -Bild oder -Layout, um das Hintergrunddesign zu definieren.
  • Seitenanpassungsfähigkeit: Aus HTML gerenderte Hintergründe passen sich automatisch an die Abmessungen der Ziel-PDF-Seite an.
  • Dynamische Generierung: Erstellen Sie Hintergründe programmatisch aus Daten, Benutzervorlieben oder Vorlagenlogik.
  • Leichtgewichtiges Output: CSS-definierte Hintergründe sind kleiner als Rasterbilder bei gleicher visueller Qualität.

Diese Funktionalität eignet sich für Erstellen von Formularen mit Unternehmensbriefköpfen oder Hinzufügen von benutzerdefinierten Wasserzeichen zu rechtlichen und finanziellen Dokumenten.

Wie füge ich bestimmten Seiten einen Hintergrund hinzu?

Die Methodee addBackgroundPdf akzeptiert ein optionales Argument PageSelection, das die Operation auf die von Ihnen angegebenen Seiten beschränkt. Verwenden Sie PageSelection.firstPage(), PageSelection.lastPage(), PageSelection.singlePage(int index) oder PageSelection.pageRange(int start, int end), um beliebige Teilmengen von Seiten anzusprechen. Die vollständige Dokumentation zu PageSelection ist in der IronPDF for Java API Referenz verfügbar.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background-specific-page.java
import com.ironsoftware.ironPdf.*;
import com.ironsoftware.ironPdf.edit.PageSelection;
import java.nio.file.Paths;

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load a background from an existing PDF file
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Apply only the first page of the background PDF to the first page of the target
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background-specific-page.java
import com.ironsoftware.ironPdf.*;
import com.ironsoftware.ironPdf.edit.PageSelection;
import java.nio.file.Paths;

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load a background from an existing PDF file
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Apply only the first page of the background PDF to the first page of the target
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
JAVA

Das zweite Argument (0) ist der backgroundPdfPageIndex, ein nullbasierter Index, der festlegt, welche Seite des Hintergrund-PDFs als Quelle verwendet werden soll. Wenn Ihre Hintergrundvorlage mehrere Seitendesigns enthält, können Sie mit diesem Parameter unterschiedliche Designs auf verschiedene Abschnitte des Zieldokuments anwenden. Kombinieren Sie selektive Hintergründe mit PDF-Splitting und -Merging Beispiele, um mehrstufige Dokumenten-Assembly-Workflows zu erstellen.

Wann sollten Sie Hintergründe auf bestimmte Seiten anwenden?

Die selektive Anwendung von Hintergründen deckt eine Reihe von gängigen Dokumentszenarien ab:

  • Titelblätter: Kennzeichnen Sie die erste Seite mit einem vollflächigen Design, während die Körperseiten sauber bleiben.
  • Kapiteltreiler: Wenden Sie Abschnittshintergründe auf die erste Seite jedes Kapitels an.
  • Rechtsgültige Authentifizierung: Fügen Sie einen offiziellen Briefkopf nur zu Seiten hinzu, die eine formale Zertifizierung erfordern.
  • Vertrauliche Abschnitte: Bestimmte Seiten tönen oder markieren, um eingeschränkte Inhalte anzuzeigen.
  • Druckfertige Layouts: Seiten, die für den physischen Druck bestimmt sind, mit schnittsicheren Hintergründen versehen.

Nach Anwendung hochauflösender Hintergrundbilder sollten Sie erwägen, das Ausgabe-PDF zu komprimieren, um die Dateigrößen für die Verteilung oder Archivierung handhabbar zu halten.

Wie füge ich ein Vordergrundoverlay zu einem PDF hinzu?

Die addForegroundPdf-Methodee fügt eine PDF-Ebene über den bestehenden Seiteninhalt. Der gerenderte Vordergrund erscheint über allen vorhandenen Texten, Bildern und Grafiken auf jeder Zielseite. Diese Methodee ist der Standardansatz für Wasserzeichen, Genehmigungsstempel und Überarbeitungsindikatoren, die unabhängig vom zugrunde liegenden Inhalt sichtbar bleiben müssen. Für funktionierende Codebeispiele siehe die Java-Beispiele für Hintergründe und Vordergründe.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a diagonal text stamp as the foreground layer
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to all pages
pdf.addForegroundPDF(foreground);

pdf.saveAs(Paths.get("overlayForeground.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import java.nio.file.Paths;

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a diagonal text stamp as the foreground layer
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to all pages
pdf.addForegroundPDF(foreground);

pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

Die CSS-Eigenschaft opacity steuert die Transparenz, sodass der Stempel im Vordergrund den darunterliegenden Inhalt nicht vollständig verdeckt. Die Eigenschaft transform: rotate() wendet eine diagonale Ausrichtung an, was für Entwurfs- und Vertraulichkeits-Wasserzeichen Standard ist. Die Bibliothek verwaltet alle Überlagerungen intern; keine manuelle Manipulation des PDF-Datenstroms ist erforderlich.

Hinweis:Die Darstellung im Vordergrund verwendet dieselbe HTML-zu-PDF-Engine wie renderHtmlAsPdf. Jedes CSS, das in einem modernen Browser funktioniert (einschließlich @font-face, Flexbox und CSS-Variablen), erzeugt in der Vordergrundebene identische Ergebnisse.

Wie sieht die Ausgabe im Vordergrund aus?

Warum Foreground Overlays anstelle von Hintergründen verwenden?

Vordergrundoverlays erfüllen eine andere Rolle als Hintergründe und sind die richtige Wahl, wenn der hinzuzufügende Inhalt über dem vorhandenen Seitenmaterial erscheinen muss:

  • Entwurfs- und Vertraulichkeitsstempel: Deutlichen, aber transparenten Text über Seiten platzieren, ohne vorhandenen Inhalt zu entfernen.
  • Genehmigungs- und Überprüfungsanmerkungen: Unterschriftsanzeigen oder Rezensentenanmerkungen auf fertigen Dokumenten überlagern.
  • Sicherheitskennungen: Verfolgungscodes oder eindeutige Dokumentkennungen hinzufügen, die über allen Seiteninhalten liegen.
  • Ablaufindikatoren: Zeitkritische Dokumente mit sichtbaren Hinweisen markieren, die über Daten- oder Diagrammtabellen erscheinen.
  • Zertifizierungsmarken: Logos oder Siegel über finalem Inhalt anwenden, die nicht durch bestehende Seitenelemente verdeckt werden können.

Vordergrundoverlays funktionieren gut mit PDF-Formularfüllung in Java, wenn Sie Statusanzeigen oder Genehmigungsstempel über abgeschlossenen Formulardaten platzieren müssen.

Wie füge ich einen Vordergrund zu bestimmten Seiten hinzu?

Die addForegroundPdf-Methodee akzeptiert ein PageSelection-Argument auf dieselbe Weise wie addBackgroundPdf. Verwenden Sie PageSelection.pageRange(int start, int end), um den Vordergrund auf einen zusammenhängenden Bereich zu beschränken, oder übergeben Sie ein List<Integer>, um nicht aufeinanderfolgende Seiten anzusprechen.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground-page-range.java
import com.ironsoftware.ironPdf.*;
import com.ironsoftware.ironPdf.edit.PageSelection;
import java.nio.file.Paths;

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground overlay
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to pages 2 through 8 (zero-based index: 1 to 7)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

pdf.saveAs(Paths.get("overlayForeground.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground-page-range.java
import com.ironsoftware.ironPdf.*;
import com.ironsoftware.ironPdf.edit.PageSelection;
import java.nio.file.Paths;

// Laden Sie das Ziel-PDF
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground overlay
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to pages 2 through 8 (zero-based index: 1 to 7)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

WichtigDer pageRange-Index ist in einigen Überladungen einsbasiert und in anderen nullbasiert, je nachdem, welche Überladung Sie aufrufen. Überprüfen Sie die IronPDF Java API Referenz für das spezifische Überladungssignatur, um die Indexierungskonvention in Ihrer Version zu bestätigen.

Wann sollten Sie Seitenbereiche für Vordergründe verwenden?

Die seitenbezogene Anwendung des Vordergrunds ist in mehreren Produktionsszenarien nützlich:

  • Dokumentenabschnitte: Ein "ENTWURF"-Overlay nur auf den Anhang oder ergänzende Seiten stempeln.
  • Versionsverfolgung: Aktualisierte Seiten mit einem Überarbeitungsstempel markieren, während nicht geänderte Seiten unverändert bleiben.
  • Selektive Vertraulichkeit: Ein "EINGESCHRÄNKT"-Overlay nur auf die Seiten anwenden, die vertrauliche Finanz- oder medizinische Daten enthalten.
  • Mehrsprachige Dokumente: Sprachspezifische Hinweise auf den relevanten Seiten eines zweisprachigen Dokuments platzieren.
  • Vertragsmanagement: Ein "UNGÜLTIG"-Overlay auf abgelaufene Vertragsseiten hinzufügen, ohne das gesamte Dokument zu ändern.

Was sind häufige Seitenauswahlmuster?

Die folgenden Muster decken die meisten selektiven Überlagerungsszenarien ab:

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/page-selection-patterns.java
import com.ironsoftware.ironPdf.*;
import com.ironsoftware.ironPdf.edit.PageSelection;
import java.util.ArrayList;
import java.util.List;
import java.nio.file.Paths;

PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.4;'>DRAFT</h1>");
PdfDocument background1 = PdfDocument.fromFile(Paths.get("cover-background.pdf"));
PdfDocument background2 = PdfDocument.fromFile(Paths.get("end-background.pdf"));

// Apply foreground to all even-numbered pages (zero-based)
List<Integer> evenPages = new ArrayList<>();
for (int i = 1; i < pdf.getPageCount(); i += 2) {
    evenPages.add(i);
}
pdf.addForegroundPdf(foreground, PageSelection.pageRange(evenPages));

// Apply different backgrounds to the first and last pages
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply foreground to all pages except the first and last
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}

pdf.saveAs(Paths.get("selective-overlay.pdf"));
//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/page-selection-patterns.java
import com.ironsoftware.ironPdf.*;
import com.ironsoftware.ironPdf.edit.PageSelection;
import java.util.ArrayList;
import java.util.List;
import java.nio.file.Paths;

PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.4;'>DRAFT</h1>");
PdfDocument background1 = PdfDocument.fromFile(Paths.get("cover-background.pdf"));
PdfDocument background2 = PdfDocument.fromFile(Paths.get("end-background.pdf"));

// Apply foreground to all even-numbered pages (zero-based)
List<Integer> evenPages = new ArrayList<>();
for (int i = 1; i < pdf.getPageCount(); i += 2) {
    evenPages.add(i);
}
pdf.addForegroundPdf(foreground, PageSelection.pageRange(evenPages));

// Apply different backgrounds to the first and last pages
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply foreground to all pages except the first and last
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}

pdf.saveAs(Paths.get("selective-overlay.pdf"));
JAVA

TippsVerketten Sie mehrere addBackgroundPdf- und addForegroundPdf-Aufrufe auf demselben PdfDocument, um mehrschichtige Vorlagen zu erstellen. Tragen Sie beispielsweise eine Markenfarbfüllung als Hintergrund auf und fügen Sie dann in einem einzigen Ablauf einen Vertraulichkeitsstempel als Vordergrund hinzu.

Welche Methodeen bietet die Klasse PageSelection?

Die Klasse PageSelection steuert, welche Seiten die Hintergrund- oder Vordergrundebene erhalten. Alle integrierten Factory-Methodeen geben ein PageSelection-Objekt zurück, das sowohl von addBackgroundPdf als auch von addForegroundPdf akzeptiert wird.

PageSelection-Fabrikmethoden zum Anvisieren bestimmter Seiten in addBackgroundPdf und addForegroundPdf
MethodeBeschreibung
firstPage()Zielt auf die erste Seite des PDFs
lastPage()Zielt auf die letzte Seite des PDFs
singlePage(int index)Zielt auf eine Seite nach nullbasiertem Index
pageRange(int start, int end)Zielt auf einen zusammenhängenden Seitenbereich (einschließlich)
pageRange(List pageList)Zielt auf eine nicht-sequentielle Liste von Seiten
allPages()Zielt auf alle Seiten (Standard, wenn keine Auswahl übergeben wird)

Wie wählt man die richtige PageSelection-Methodee aus?

Die Wahl der Methodee hängt von der Dokumentstruktur und dem Umfang der Überlagerung ab:

  • firstPage(): Deckblätter, Titelseiten und einleitende Designelemente.
  • lastPage(): Signaturblöcke, Hinweise am Ende des Dokuments und abschließende Zusammenfassungen.
  • singlePage(): Zertifikate, Formulare oder einzelne Seiten, die einer besonderen Behandlung bedürfen.
  • pageRange(start, end): Kapitel, Anhänge oder beliebige zusammenhängende Dokumentabschnitte.
  • pageRange(List): Nicht fortlaufende Auswahlen wie alle ungeraden Seiten oder eine manuell festgelegte Gruppe.

Für vollständige Parameterdokumentation und Methodee-Überladungs-Signaturen siehe die IronPDF Java API Referenz.

Was sind die nächsten Schritte für das Hinzufügen von Hintergründen und Vordergründen zu PDFs?

Die Methodeen addBackgroundPdf und addForegroundPdf decken die gesamte Bandbreite an PDF-Overlay-Szenarien ab, von einfachen Farbfüllungen und Wasserzeichen bis hin zu Workflows zur Dokumentenzusammenstellung mit mehreren Vorlagen. Kombinieren Sie sie mit PageSelection, um unterschiedliche Designs pro Abschnitt anzuwenden, oder verketten Sie sie mit anderen PdfDocument-Methodeen, um produktionsreife Dokumentenpipelines zu erstellen. Für zusätzliche Overlay-Techniken wie Text- und Bildstempel erkunden Sie den Text- und Bildstempel-Leitfaden oder Anmerkungsbeispiele for Java.

Um diese Funktionen in Ihrem Projekt zu nutzen, starten Sie eine kostenlose Testversion von IronPDF for Java oder sehen Sie sich Lizenzierungsoptionen für den kommerziellen Einsatz an. IronPDF ist über Maven Central verfügbar und unterstützt Java 8 und später unter Windows, Linux und macOS.

Bereit zu sehen, was IronPDF sonst noch kann? Erkunden Sie das vollständige HTML-PDF-Tutorial for Java für einen vollständigen Überblick über Rendering-, Manipulations- und Exportoptionen.

Häufig gestellte Fragen

Wie füge ich in Java einen Hintergrund zu einer bestehenden PDF-Datei hinzu?

Laden Sie das Ziel-PDF mit PdfDocument.fromFile(), erstellen Sie ein Hintergrund-PDF mit PdfDocument.renderHtmlAsPdf() unter Verwendung Ihres HTML/CSS und rufen Sie dann pdf.addBackgroundPdf(background) auf, um es hinter allen Seiten zu komponieren. Aktivieren Sie die Bibliothek zuerst mit License.setLicenseKey().

Was ist der Unterschied zwischen addBackgroundPdf und addForegroundPdf?

addBackgroundPdf platziert die Quell-PDF-Schicht hinter dem vorhandenen Seiteninhalt, was es geeignet macht für Briefköpfe, Farbfelder und Designvorlagen. addForegroundPdf platziert die Schicht über dem vorhandenen Inhalt, was es geeignet macht für Wasserzeichen, Entwurfstempele, Genehmigungsindikatoren und Vertraulichkeitshinweise.

Kann ich nur bestimmten Seiten einen Hintergrund oder Vordergrund anwenden?

Ja. Sowohl addBackgroundPdf als auch addForegroundPdf akzeptieren ein optionales PageSelection-Argument. Verwenden Sie PageSelection.firstPage(), PageSelection.lastPage(), PageSelection.singlePage(int index) oder PageSelection.pageRange(int start, int end), um ein Untermenge von Seiten anzusprechen.

Wie erstelle ich einen PDF-Hintergrund mit HTML und CSS?

Rufen Sie PdfDocument.renderHtmlAsPdf() auf und übergeben Sie Ihre HTML-Zeichenfolge. IronPDF unterstützt modernes CSS einschließlich Gradients, Hintergrundbilder, benutzerdefinierte Schriften und Transparenzen. Die gerenderte Seite skaliert automatisch, um den Dimensionen des Zieldokuments zu entsprechen.

Was steuert der Parameter backgroundPdfPageIndex?

Das zweite Integer-Argument für addBackgroundPdf ist der nullbasierte Seitenindex innerhalb des Hintergrund-PDFs, das als Quelle verwendet wird. Wenn Ihr Hintergrundvorlage mehrere Seitendesigns hat, übergeben Sie verschiedene Indexwerte, um verschiedene Designs auf verschiedene Abschnitte des Zieldokuments anzuwenden.

Ist eine Lizenz erforderlich, um Hintergründe und Vordergründe in Java hinzuzufügen?

Ja. Setzen Sie vor API-Aufrufen einen gültigen Lizenzschlüssel mit License.setLicenseKey(). Kostenlose Testlizenzen sind zur Evaluierung unter ironpdf.com verfügbar. Die Bibliothek erfordert eine ordnungsgemäße Lizenzierung für den Produktionseinsatz.

Darrius Serrant
Darrius Serrant
  Jetzt mit dem Ingenieurteam chatten
Full-Stack-Software-Ingenieur (WebOps)

Darrius Serrant hat einen Bachelor-Abschluss in Informatik von der University of Miami und arbeitet als Full-Stack-WebOps-Marketing-Ingenieur bei Iron Software. Seit seiner Jugend vom Programmieren angezogen, sah er die Informatik als sowohl mysteriös als auch zugänglich, was es zum perfekten Medium für Kreativität und Problemlösung ...

Weiterlesen
Bereit anzufangen?
Version: 2026.5 just released
Still Scrolling Icon

Scrollst du immer noch?

Sie brauchen schnell einen Beweis?
Führen Sie eine Probe aus Sehen Sie zu, wie Ihr HTML-Code in eine PDF-Datei umgewandelt wird.