C#でPDFのカスタムマージンを設定する方法

IronPDFでカスタムマージンを設定する方法

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

IronPDF を使用すると、開発者は ChromePdfRendererRenderingOptions の簡単な構成を通じて HTML から PDF をレンダリングするときにカスタム マージンを設定でき、上、下、左、右のマージンをミリメートル単位で正確に制御できます。

クイックスタート: IronPDFを使用してカスタム PDF マージンを実装する

HTMLからPDFをレンダリングする際、簡単な設定でカスタムマージンを設定できます。

  1. IronPDF をNuGetパッケージマネージャでインストール

    PM > Install-Package IronPdf
  2. このコード スニペットをコピーして実行します。

    new IronPdf.ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10, UseMarginsOnHeaderAndFooter = true } }
        .RenderHtmlAsPdf("<h1>Hello with margins!</h1>")
        .SaveAs("custom-margins.pdf");
  3. 実際の環境でテストするためにデプロイする

    今日プロジェクトで IronPDF を使い始めましょう無料トライアル

    arrow pointer

最小限のワークフロー(5つのステップ):

1.NuGetからIronPDFをダウンロードしてください。

  1. ChromePdfRenderer クラスをインスタンス化する
  2. RenderingOptionsでマージン値を設定します。 4.ヘッダーとフッターのマージン動作の設定 5.HTMLをPDFにレンダリングして保存

IronPDFでカスタムPDFマージンを設定するには?

カスタム マージンを設定するには、ChromePdfRenderer クラスをインスタンス化します。 RenderingOptions オブジェクトにアクセスして、上、下、左、右の特定の余白をミリメートル単位で設定します。

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 40;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
renderer.RenderingOptions.MarginBottom = 40;
$vbLabelText   $csharpLabel

マージン設定は正確なHTMLからPDFへの変換を提供するIronPDFのChromeレンダリングエンジンで動作します。 高度なPDF生成設定については、レンダリングオプションのガイドを参照してください。

マージンは CSS スタイルとどのように相互作用しますか?

余白は、HTML style セクションで設定された余白に追加されます。 以下の例では、HTML の余白は 50 mm で、RenderingOptions によって 30 mm が追加され、合計余白は 80 mm になります。

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins-with-css.cs
const string htmlWithStyle = @"
<!DOCTYPE html>
<html>
    <head>
        <style>
            body {margin: 50mm 50mm 50mm 50mm;}
        </style>
    </head>
<body>
    <h1>Hello World!</h1>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.MarginTop = 30;
renderer.RenderingOptions.MarginLeft = 30;
renderer.RenderingOptions.MarginRight = 30;
renderer.RenderingOptions.MarginBottom = 30;

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlWithStyle);
pdf.SaveAs("PdfWithCustomMargins.pdf");
$vbLabelText   $csharpLabel

結果としてのPDFは以下に示されています。

HTMLドキュメントでCSSを使用する場合、IronPdfはレスポンシブCSSとメディアクエリーをサポートし、プロフェッショナルなレイアウトを可能にします。 HTMLファイルをPDFに変換するときや、HTML文字列を扱うときに、このマージン動作が重要になります。

異なる規格のマージン値の共通点は何ですか?

文書には、さまざまな標準を満たすために特定の余白が必要になることがよくあります。 MLAおよびAPA形式では1インチの余白が必要ですが、学位論文では1.5インチの余白が必要な場合があります。

一般的なマージン規格とミリメートル換算:

  • MLA/APAフォーマット:1インチ(25.4mm)四方
  • 論文フォーマット:1.5インチ(38.1mm)四方
  • ビジネスレター:側面1インチ、天地2インチ(50.8mm)。
  • ヨーロッパA4規格:全辺20mm
  • 狭いマージン:0.5インチ(12.7mm)全辺

これらの標準を実装する際、IronPDFはカスタム用紙サイズをサポートし、特定の地域や組織の要件を満たす文書を可能にします。

ヘッダーとフッターにカスタム余白を適用するにはどうすればよいですか?

デフォルトでは、RenderingOptions で設定された余白はヘッダーとフッターには適用されません。 ヘッダーとフッターにドキュメントの余白を適用するには、UseMarginsOnHeaderAndFooter プロパティを構成します。

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.cs
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;
$vbLabelText   $csharpLabel

動的コンテンツとスタイルによるヘッダーとフッターの実装については、ヘッダーとフッターの追加のガイドを参照してください。

ヘッダーとフッターに選択的に余白を適用するにはどうすればよいですか?

ヘッダーとフッターに適用する余白を指定します。 詳細な設定はAPI Referenceを参照してください。 例

:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-specific-margins-header-footer.cs
// Use only the left margin from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.Left;

// Use only the left and right margins from the document.
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.LeftAndRight;
$vbLabelText   $csharpLabel

異なるヘッダー/フッターマージン設定はいつ使うべきですか

ヘッダーとフッターの選択的余白設定は、ページ余白が交互にある書籍や、本文は余白を維持しながらヘッダーがページ端まで伸びているような、非対称レイアウトの文書に効果的です。

一般的な使用例

  • 書籍出版:内側と外側の余白を交互に綴じる
  • レターヘッド文書:全角ヘッダーと制約のある本文
  • フォームとテンプレート:フィールドと命令の余白の違い
  • 複数カラムのレイアウト:列の余白がある全幅のヘッダー

高度なマージンの考慮事項

改ページと余白を扱う

カスタムマージンは、改ページと相互作用します。 IronPDFは余白の設定を尊重しながらページ間のコンテンツの流れを処理し、複数ページのドキュメントで一貫した書式を保証します。

マージンの単位と精度

IronPDFは余白にミリメートルを使用しています。 他の単位からの変換

  • インチ→mm:25.4倍
  • mmポイント:0.352778を掛ける
  • ピクセル→mm:DPIによって異なります(96 DPIの場合、0.264583を掛けます)。

IronPdfは必要に応じてミリメートル以下の精度の小数値をサポートします。

マージンによるパフォーマンスの最適化

カスタムマージンのある大型ドキュメントの場合:

  1. マージンをrendererレベルで一度設定する 2.類似文書間で一貫した値を使用 3.マージン設定を他のレンダリング オプションと組み合わせてください。

他のIronPDF機能と統合する

カスタムマージンはIronPdfの他の機能とも連動します:

結論

IronPdfでカスタムマージンを設定することで、PDFのレイアウトとフォーマットを正確にコントロールすることができます。 ビジネス文書、学術論文、カスタムレポートのいずれを作成する場合でも、IronPdfのマージンシステムはPDFが正確な仕様を満たすことを保証します。 ドキュメンテーションをご覧いただき、IronPDFがどのようにPDF生成のワークフローを効率化できるかをご確認ください。

よくある質問

C# で PDF にカ ス タ ムの余白を設定す る 方法は?

IronPDFでは、ChromePdfRendererのRenderingOptionsを設定することでカスタムマージンを設定できます。MarginTop、MarginBottom、MarginLeft、MarginRightプロパティをミリメートル単位で設定するだけです。例: new ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10 }.}.

マージンの測定にはどのような単位が使用されますか?

IronPDFはRenderingOptionsのすべてのマージン設定の単位としてミリメートル(mm)を使用します。これにより、PDFのレイアウトを正確に制御し、異なる文書規格間での一貫性を保証します。

IronPDFの余白はHTMLのCSSの余白とどのように相互作用しますか?

IronPDFの余白はHTMLで定義されたCSSの余白に加算されます。HTMLの余白が50mmで、RenderingOptionsで30mmを設定した場合、最終的なPDFの余白は合計80mmになります。これにより、HTMLのスタイルを維持しながら、間隔を柔軟にコントロールすることができます。

ヘッダーとフッターに余白を付けることはできますか?

はい、IronPDFはRenderingOptionsのUseMarginsOnHeaderAndFooterプロパティを提供します。これをtrueに設定すると、カスタムマージンがヘッダーとフッターに適用され、PDFドキュメント全体で一貫した間隔が確保されます。

学術的なフォーマットで推奨されるマージン値は?

IronPDFを使用する学術文書では、MLA/APAフォーマットでは25.4mm (1インチ)、学位論文では38.1mm (1.5インチ)、ヨーロッパA4標準では20mmを使用します。これらの値はMarginTop、MarginBottom、MarginLeft、MarginRightプロパティで簡単に設定できます。

Chromeのレンダリングエンジンはマージンの精度に影響しますか?

IronPDFのChromeレンダリングエンジンは最新のウェブ標準にマッチした高精度のマージンレンダリングを保証します。これにより、HTMLをPDFに変換する際、RenderingOptionsで定義された正確な間隔を維持し、一貫した結果を提供します。

PDFの各辺に異なる余白を設定できますか?

もちろんです。IronPDFは4つのマージンを別々のプロパティでコントロールすることができます:MarginTop、MarginBottom、MarginLeft、MarginRightです。これにより、ビジネスレターのような上下の余白が大きい非対称レイアウトが可能になります。

コンテンツエリアを最大化するために、余白を狭くするにはどうすればよいですか?

IronPDFで余白を狭くするには、RenderingOptionsですべての余白値を12.7mm(0.5インチ)に設定します。これにより、プロフェッショナルな外観を維持しながら印刷可能領域を最大化できます:RenderingOptions = { MarginTop = 12.7, MarginBottom = 12.7, MarginLeft = 12.7, MarginRight = 12.7 }.

Jordi Bardia
ソフトウェアエンジニア
Jordiは、最も得意な言語がPython、C#、C++であり、Iron Softwareでそのスキルを発揮していない時は、ゲームプログラミングをしています。製品テスト、製品開発、研究の責任を分担し、Jordiは継続的な製品改善において多大な価値を追加しています。この多様な経験は彼を挑戦させ続け、興味を持たせており、Iron Softwareで働くことの好きな側面の一つだと言います。Jordiはフロリダ州マイアミで育ち、フロリダ大学でコンピュータサイエンスと統計学を学びました。
準備はできましたか?
Nuget ダウンロード 17,803,474 | バージョン: 2026.3 リリース
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。