IRONPDFの使用

C#でPDFスタンプを追加する方法

更新済み 2024年3月24日
共有:

PDFにテキストや画像をスタンプすることは、既存のPDFドキュメントに追加のコンテンツを重ねる作業を含みます。 このコンテンツは、テキスト、画像、またはその組み合わせとしてよく「スタンプ」と呼ばれます。 通常、ユーザーはスタンプを使用してPDFに情報、ラベル、透かし、または注釈を追加します。

IronPDFさまざまなニーズに対応するためにPDFコンテンツをカスタマイズできる、ユーザーフレンドリーで多用途のソリューションを提供します。 Stamper アブストラクトクラスは、特定の目的のために設計されたさまざまな特殊StampingクラスのためのIronPDFのStampingメソッドの重要なコンポーネントです。

  1. TextStamper: TextStamperは、PDFに説明テキストを追加するためのソリューションです。 既存のドキュメントを強化する場合、同じページにテキストを配置する場合、または他のPDFドキュメントからの詳細を組み込む場合でも、このスタンパーを使用すると、ファイルの説明や情報でファイルをカスタマイズできます。

  2. ImageStamper: ImageStamperは、PDF内に画像を配置するための最適なツールです。 ファイル説明のためのロゴでも、既存のドキュメント用のイラストでも、同じページや他のPDFドキュメント用のビジュアル要素でも、このスタンパーは画像のシームレスな統合を保証します。

  3. HtmlStamper: HtmlStamperはカスタマイズを次のレベルに引き上げ、HTMLコンテンツをPDFにスタンプすることができます。 これは、インタラクティブなコンテンツ、説明、ファイル仕様などの動的な要素の作成を含み、従来のPDFカスタマイズを超えた柔軟性を提供します。

  4. バコードをスタンプするためのBarcodeStamper: BarcodeStamperはPDFにバコードを追加するプロセスを簡素化します。 署名された文書、一時ファイル、またはファイル添付の追跡目的であれ、このスタンパーはバーコードを効率的にPDFに統合することを保証します。

  5. QRコードをスタンプするBarcodeStamper: BarcodeStamperはPDF上にQRコードを配置することを専門としています。 インタラクティブなコンテンツやファイルの添付に最適なこのスタンパーは、同じページまたは他のPDFドキュメントにQRコードを埋め込み、追加情報に簡単にアクセスできるようにします。

    これらの専門的なスタンパークラスは、基本的なテキストから詳細なHTMLデザインや動的なバーコードに至るまで、さまざまな要素でPDF文書を簡単に強化することをユーザーに可能にします。 この記事では、主なスタンパー3つの機能について探っていきます。TextStamperでテキストを追加する, ImageStamperで画像を配置する、およびHtmlStamperとHTMLの統合. HTMLStamperは、特に強力です。なぜなら、すべてのHTML機能を活用できるだけでなく、CSSスタイリングとも組み合わせることで、スタンピングプロセスにさらに多様性をもたらすことができるからです。

PDFにテキストと画像をスタンプする方法

  1. テキストや画像をスタンプするためのC#ライブラリをダウンロードしてください。

  2. 望むスタンプクラスを作成および設定します。

  3. 「ApplyStamp」メソッドを使用してPDFにスタンプを適用します。

  4. 「ApplyMultipleStamps」メソッドを使用して複数のスタンプを適用します。

  5. 特定のページにスタンプを適用するよう指定します。

PDFにテキストスタンプを設定および適用する方法

最初に、PDFにテキストスタンプをサポートするために、TextStamperクラスからオブジェクトを作成します。 このクラスのオブジェクトには、テキストスタンパーがどのように表示されるかを指定するためのすべての設定が含まれています。 textStamperオブジェクトを 'ApplyStamp' メソッドに渡します。 Textプロパティは、PDFに表示されるコンテンツを定義します。

さらに、フォントファミリー、フォントスタイル、およびスタンプの位置を指定することが可能です。このカスタマイズは、インタラクティブ要素、ファイルの説明、および同じまたは他のPDFの既存のコンテンツにも拡張されます。 次に、実際のファイル名でPDFをエクスポートします。

設定を完了したら、すべての設定を反映させた出力PDFファイルを指定されたファイル名でエクスポートし、ドキュメントにプロフェッショナルな仕上げを提供してください。

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

pdf.SaveAs("stampText.pdf");
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create text stamper
TextStamper textStamper = new TextStamper()
{
    Text = "Text Stamper!",
    FontFamily = "Bungee Spice",
    UseGoogleFont = true,
    FontSize = 30,
    IsBold = true,
    IsItalic = true,
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the text stamper
pdf.ApplyStamp(textStamper);

pdf.SaveAs("stampText.pdf");
Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")

' Create text stamper
Private textStamper As New TextStamper() With {
	.Text = "Text Stamper!",
	.FontFamily = "Bungee Spice",
	.UseGoogleFont = True,
	.FontSize = 30,
	.IsBold = True,
	.IsItalic = True,
	.VerticalAlignment = VerticalAlignment.Top
}

' Stamp the text stamper
pdf.ApplyStamp(textStamper)

pdf.SaveAs("stampText.pdf")
VB   C#

PDFに画像スタンプを設定して適用する方法

テキストスタンパーと同様に、ImageStamperクラスからオブジェクトを作成し、その後を使用します。ImageStamper 適用方法ドキュメントに画像を適用します。 このメソッドの2番目のパラメーターはページインデックスも受け入れ、単一または複数のページにスタンプを適用することができます。 この特定のインスタンスは、システムに画像を特にPDFの最初のページにスタンプとして適用するように指示することができます。

すべてのページインデックスはゼロベースのインデックスを使用します。

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create image stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0);

pdf.SaveAs("stampImage.pdf");
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create image stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0);

pdf.SaveAs("stampImage.pdf");
Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")

' Create image stamper
Private imageStamper As New ImageStamper(New Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg")) With {.VerticalAlignment = VerticalAlignment.Top}

' Stamp the image stamper
pdf.ApplyStamp(imageStamper, 0)

pdf.SaveAs("stampImage.pdf")
VB   C#

複数のスタンプを適用

ドキュメントに複数のスタンプを追加するには、次のメソッドを使用します。複数のスタンプの適用スタンパーの配列を渡すことで、IronPDFでスタンパーの配列を作成することができます。 それはテキスト、画像、またはラベルなどのさまざまな要素を一度に追加することができます。 この例では、異なるテキストと配置を持つ2つのテキストスタンプが作成されました。pdf.ApplyMultipleStamps は両方のスタンプをPDFに適用し、最終的なドキュメントは multipleStamps.pdf として保存されます。 このメソッドは、様々なスタンプを追加するプロセスを効率化し、同じページ、別のPDF、または空白のページに複数の要素を簡単に追加する便利な方法を提供します。

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper [] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

pdf.SaveAs("multipleStamps.pdf");
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create two text stampers
TextStamper stamper1 = new TextStamper()
{
    Text = "Text stamp 1",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Left,
};

TextStamper stamper2 = new TextStamper()
{
    Text = "Text stamp 2",
    VerticalAlignment = VerticalAlignment.Top,
    HorizontalAlignment = HorizontalAlignment.Right,
};

Stamper [] stampersToApply = { stamper1, stamper2 };

// Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply);

pdf.SaveAs("multipleStamps.pdf");
Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")

' Create two text stampers
Private stamper1 As New TextStamper() With {
	.Text = "Text stamp 1",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Left
}

Private stamper2 As New TextStamper() With {
	.Text = "Text stamp 2",
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalAlignment = HorizontalAlignment.Right
}

Private stampersToApply() As Stamper = { stamper1, stamper2 }

' Apply multiple stamps
pdf.ApplyMultipleStamps(stampersToApply)

pdf.SaveAs("multipleStamps.pdf")
VB   C#

PDFドキュメントにおけるスタンプ位置の指定

スタンプの配置を定義するには、水平3列および垂直3行の3x3グリッドを使用します。 水平方向の配置には、左揃え、中央揃え、右揃えの選択肢があり、垂直方向の配置には、上揃え、中央揃え、下揃えの選択肢があります。 それぞれの位置に対して、水平および垂直オフセットを調整することで、より高い精度を実現できます。 このコンセプトの視覚的表現については、下の画像をご参照ください。

C#でPDFスタンパーを追加する方法, 図1: PDFスタンパーの位置設定

PDFスタンパーの位置調整

  • 水平位置: ページに対するスタンプの水平位置合わせ。
  • VerticalAlignment: ページに対するスタンプの垂直方向の配置。
  • HorizontalOffset:水平オフセット。 デフォルト値は0で、デフォルトの単位はIronPDF.Editing.MeasurementUnit.Percentageです。 正の値は右方向へのオフセットを示し、負の値は左方向へのオフセットを示します。
  • VerticalOffset: 垂直オフセット。 デフォルト値は0で、デフォルトの単位はIronPDF.Editing.MeasurementUnit.Percentageです。 正の値は下方向のオフセットを示し、負の値は上方向のオフセットを示します。

    HorizontalOffsetVerticalOffsetプロパティを指定するには、以下の手順でインスタンス化します。長さ指定クラス詳細な測定については、こちらをご覧ください。 Lengthのデフォルトの測定単位はパーセンテージですが、インチ、ミリメートル、センチメートル、ピクセル、ポイントなどの測定単位も使用できます。

using IronPdf.Editing;

// Create text stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};
using IronPdf.Editing;

// Create text stamper
ImageStamper imageStamper = new ImageStamper(new Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg"))
{
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Top,

    // Specify offsets
    HorizontalOffset = new Length(10),
    VerticalOffset = new Length(10),
};
Imports IronPdf.Editing

' Create text stamper
Private imageStamper As New ImageStamper(New Uri("https://ironpdf.com/img/svgs/iron-pdf-logo.svg")) With {
	.HorizontalAlignment = HorizontalAlignment.Center,
	.VerticalAlignment = VerticalAlignment.Top,
	.HorizontalOffset = New Length(10),
	.VerticalOffset = New Length(10)
}
VB   C#

PDFにおけるHTMLスタンプの設定および適用

テキストと画像の両方をスタンプするために使用できる別のスタンパークラスがあります。 についてHTML統合のためのHtmlStamperクラスHTMLデザインをCSSスタイリングでレンダリングし、PDFドキュメントにスタンプすることができます。 InnerHtmlBaseUrlプロパティは、CSSや画像ファイルなどのHTML文字列アセットのベースURLを指定するために使用されます。

HtmlStamperクラスがPDFに適用されます。 このスタンパーオブジェクトには画像とテキストが含まれており、これらをPDFにスタンプするHTMLフラグメントに定義できます。 すべてのJavaScript、CSS、および画像ファイルへの外部参照は、内部のHtmlプロパティに対して相対的なものとなります。 このコードを使用すると、HTMLコンテンツで言及されている特定のファイル仕様に従ってPDFをカスタマイズすることができます。 最後に、変更されたPDFはファイル名「stampHtml.pdf」で保存されます。

using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create HTML stamper
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper);

pdf.SaveAs("stampHtml.pdf");
using IronPdf;
using IronPdf.Editing;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>");

// Create HTML stamper
HtmlStamper htmlStamper = new HtmlStamper()
{
    Html = @"<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
    VerticalAlignment = VerticalAlignment.Top,
};

// Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper);

pdf.SaveAs("stampHtml.pdf");
Imports IronPdf
Imports IronPdf.Editing

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Example HTML Document!</h1>")

' Create HTML stamper
Private htmlStamper As New HtmlStamper() With {
	.Html = "<img src='https://ironpdf.com/img/svgs/iron-pdf-logo.svg'>
    <h1>Iron Software</h1>",
	.VerticalAlignment = VerticalAlignment.Top
}

' Stamp the HTML stamper
pdf.ApplyStamp(htmlStamper)

pdf.SaveAs("stampHtml.pdf")
VB   C#

HTMLスタンパーオプション

上記で言及および説明されたオプションに加えて、以下にスタンパークラスで利用可能なオプションを示します。

  • 不透明度: スタンプを透明にすることができます。 0は完全に透明であり、100は完全に不透明です。
  • 回転: 指定された通り、スタンプを0度から360度時計回りに回転させます。
  • 最大幅: 出力スタンプの最大幅。
  • 最大高さ: 出力スタンプの最大高さ。
  • 最小幅 (最小幅): 出力スタンプの最小幅。
  • 最小高さ (最小高さ): 出力スタンプの最小高さ。
  • ハイパーリンク: このスタンパーのスタンプ要素にクリック時のハイパーリンクを設定します。 注: リンクによって作成されたHTMLリンク(a)被スタンプによって予約されていません。
  • スケール: スタンプにパーセンテージスケールを適用して、大きくしたり小さくしたりします。 デフォルトは100です。(パーセント)効果がありません。
  • IsStampBehindContent: スタンプをコンテンツの背面に適用するにはtrueに設定します。 コンテンツが不透明な場合、スタンプが見えなくなることがあります。
  • WaitFor:さまざまなイベントや一定の時間を待機するための便利なラッパー。
  • タイムアウト: 秒単位のレンダータイムアウト。 デフォルト値は60です。

    IronPDFのスタンパーオプションは、高度なカスタマイズを提供し、ユーザーが透明性、正確な回転、および制御された寸法でPDFを強化できるようにします。 ハイパーリンクやスケールなどの機能は、ファイル仕様に従い、コンテンツのみに重点を置きつつ、すべてのインタラクティブ要素の取り込みを容易にします。 IsStampBehindContentオプションは、スタンプを戦略的に配置し、それらがフィールドではなく、同じオブジェクトの一部であることを保証します。 同時に、WaitFor機能はレンダリングイベントを効率的に管理し、IronPDFをPDFカスタマイズのための多用途なツールにしています。これには、オリジナルページの回転が含まれます。

結論

結論として、IronPDFのスタンパー機能は、PDFドキュメントを拡張するための多用途でユーザーフレンドリーなソリューションを提供します。 シンプルなテキストラベルを追加したり、画像を組み込んだり、HTMLとCSSの力を活用してHTMLStamperを使用したりする場合でも、IronPDFは幅広いカスタマイズニーズに対応します。

テキストおよびイメージスタンプの適用例を示すことで、技術的専門知識の異なるユーザーにとっても使いやすくなっています。スタンプの透明度、回転、およびスケールを含むオプションは、PDFを手軽にカスタマイズしたいユーザーにとって包括的なツールキットを提供します。 IronPDFのスタンパー機能は、ユーザーが簡単にPDFドキュメントの品質を向上させるための信頼できる効率的なツールとして際立っています。

本質的にはIronPDFによるPDF拡張をマスターする基本的および高度なニーズの両方に対応し、PDFを簡単に向上させます埋め込みテキストと画像の抽出, PDFフォームを簡単に扱う, PDFファイルの効率的な結合または分割、およびカスタムヘッダーとカスタムフッターによるPDFの書式設定プログラムによって お問い合わせまたは機能リクエストについては、IronPdf サポートチームご利用いただけます。

< 以前
.NETでPDFをTiffファイルに変換する方法
次へ >
C#でPDFファイルを読み取る方法