如何在Java中為PDF添加背景和疊加前景

輸出的 PDF 是什麼樣子？

產生的 PDF 輸出檔案為

為何使用 HTML 來建立背景？

為 PDF 加入背景可讓您在現有內容後插入圖片或其他 PDF 文件，以信頭、水印或設計功能等元素增強其效果。 疊加前景可以讓你在 PDF 上加入其他內容，例如註解、印章或簽名。

IronPDF for Java 提供了簡單直接的方法來實現這兩點。 您可以使用已渲染或現有的 PDF 作為背景或前景覆蓋，並可靈活地將變更套用至所有頁面或特定頁面。 本指南演示了如何在 Java 中使用 IronPDF 添加背景和覆蓋前景。 當您需要使用公司信頭來建立表單，或在文件中加入自訂水印時，此功能將非常有用。

HTML 轉 PDF 的渲染方式有幾個優點：

• 彈性：使用 CSS 進行精確的造型和定位
• 適應性：建立適應不同頁面大小的背景
• 動態內容：根據資料以程式化方式產生背景
• 資源效率：比基於影像的背景更輕

如何為特定頁面新增背景？

使用相同的 addBackgroundPdf 方法，您可以為選取的頁面加入背景。 這對於應用自訂設計非常有用，例如封面或特定的品牌佈局。 PageSelection 類別是必需的，它包含有用的方法，例如 allPages, singlePage, pageRange 等等。 關於頁面操作的詳細資訊，請參閱 API Reference。

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

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

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

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

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));

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

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

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

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

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));

您可以將此技術與其他 PDF 作業結合，例如 merging PDFs 或 splitting PDFs 來建立複雜的文件工作流程。

如何在 PDF 中加入前景？

addForegroundPdf 方法會將內容覆蓋在 PDF 中現有的頁面之上。 這對於加入水印或視覺化指標等元素非常有用。 類似於背景部分，渲染前景並套用至 PDF 文件。 如需更多覆疊內容的範例，請查看 backgrounds and foregrounds code examples。

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

// Set the license key for using IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

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

// Add the rendered foreground to all pages of the PDF
pdf.addForegroundPdf(foreground)；

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));

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

// Set the license key for using IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

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

// Add the rendered foreground to all pages of the PDF
pdf.addForegroundPdf(foreground)；

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));

如何為特定頁面加入前景？

您可以使用PageSelection.pageRange方法將前景疊加到特定範圍的頁面上。 以下是如何將前景套用至第 2 頁至第 8 頁：

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

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

// Render the foreground content from HTML
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 with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));

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

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

// Render the foreground content from HTML
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 with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));

PageSelection 類別提供哪些方法？

在處理前景和背景時，IronPDF 提供了靈活的方式，使用 PageSelection 類中的方法來指定頁面。 以下是幾種選擇：

• firstPage()：將變更套用至 PDF 的第一頁
• lastPage()：將變更套用至 PDF 的最後一頁
• singlePage(int index): 根據索引（從 0 開始）瞄準特定頁面。
• pageRange(int startIndex, int endIndex): 針對 startIndex 至 endIndex (包含) 的頁面範圍。
• pageRange(List pageList): Applies changes to a list of specific pages, allowing non-sequential selections

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

// Apply to first and last page only
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

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

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

// Apply to first and last page only
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

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