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