PDFに背景とオーバーレイを追加する方法
背景を追加することにより、画像や他のPDFドキュメントを既存のPDFコンテンツの背後に背景レイヤーとして挿入することができます。 それは、レターヘッドの作成、透かしの追加、または文書に装飾要素を追加するのに役立ちます。
オーバーレイの前景では、テキスト、画像、またはその他のコンテンツを既存のPDFの上に配置することができ、効果的にオーバーレイを行います。 これは、元の内容を変更することなく、PDFに注釈、スタンプ、署名、または追加情報を追加するためによく使用されます。
IronPDFでは、背景と前景を追加することが可能で、PDFを背景および前景として使用するオプションが利用できます。
IronPDFを始めましょう
今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。
PDFに背景とオーバーレイを追加する方法
- NuGetからIronPDFライブラリをダウンロード
- 新しくレンダリングされたPDFまたは既存のPDFを背景または前景として使用
AddBackgroundPdf
メソッドを使用して背景を追加します- 前景をオーバーレイするために
AddForegroundOverlayPdf
メソッドを使用します - 特定のページに背景または前景を適用
背景を追加する例
AddBackgroundPdf
メソッドを利用して、新しくレンダリングされたまたは既存のPDF文書に背景を追加してください。 以下のコード例は、PdfDocumentオブジェクトをメソッドに提供する方法を示しています。 ただし、PDFファイルのパスを指定して、自動的にインポートし、一行のコードで背景として追加することもできます。
コード
: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");
PDFを出力
オーバーレイ前景の例
バックグラウンドを追加する場合と同様に、メインのPDFに対して、ドキュメントをインポートして前景として重ねるためのPDFファイルパスを指定することができます。 メインのPDFドキュメントに前景を重ねるには、AddForegroundOverlayPdf
メソッドを使用します。
コード
: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");
PDFを出力
背景または前景のページを選択してください
PDFのどのページを背景または前景として使用するかを選択することが可能です。 「Add Background Example」セクションの類似のコード例を使用して、背景を適用する例を見てみましょう。 異なる色を使用して背景として使用する2ページのPDFを生成します。 2 番目のパラメーターに数字 1 を指定することで、AddBackgroundPdf
メソッドで 2 ページ目を背景として使用します。
ヒント
コード
: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");
PDFを出力
指定したページに背景または前景を適用
最後に、単一ページまたは複数ページに背景や前景を適用することも可能です。 この操作には、わずかに異なるメソッド名を使用する必要があります。 AddBackgroundPdfToPage
メソッドと AddForegroundOverlayPdfToPage
メソッドを使用して、特定のPDFページにそれぞれ背景を追加し、前景をオーバーレイします。
ヒント
単一ページに適用
: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");
AddBackgroundPdfToPageRange
メソッドと AddForegroundOverlayPdfToPageRange
メソッドを使用して、複数のページにそれぞれ背景と前景を適用します。
複数のページに適用
: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");