IronPDFでカスタムマージンを設定する方法
IronPDFは、HTMLからPDFをレンダリングする際に開発者がカスタムマージンを簡単に設定できるようにするRenderingOptionsを通じて、上部、下部、左、右の余白をミリ単位で正確に制御することができます。
クイックスタート: IronPDFを使用してカスタム PDF マージンを実装する
HTMLからPDFをレンダリングする際、簡単な設定でカスタムマージンを設定できます。
-
IronPDF をNuGetパッケージマネージャでインストール
-
このコード スニペットをコピーして実行します。
new IronPdf.ChromePdfRenderer { RenderingOptions = { MarginTop = 10, MarginBottom = 10, MarginLeft = 10, MarginRight = 10, UseMarginsOnHeaderAndFooter = true } } .RenderHtmlAsPdf("<h1>Hello with margins!</h1>") .SaveAs("custom-margins.pdf"); -
実際の環境でテストするためにデプロイする
今日プロジェクトで IronPDF を使い始めましょう無料トライアル
最小限のワークフロー（5つのステップ）：
1.NuGetからIronPDFをダウンロードしてください。
ChromePdfRendererクラスをインスタンス化するRenderingOptionsでマージン値を設定する 4.ヘッダーとフッターのマージン動作の設定 5.HTMLをPDFにレンダリングして保存
IronPDFでカスタムPDFマージンを設定するには？
カスタムマージンを設定するには、ChromePdfRendererクラスをインスタンス化します。 トップ、ボトム、レフト、ライトの特定のマージンをミリメートルで設定するには、RenderingOptionsオブジェクトにアクセスします。
:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins.csChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop = 40;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;
renderer.RenderingOptions.MarginBottom = 40;Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40マージン設定は正確なHTMLからPDFへの変換を提供するIronPDFのChromeレンダリングエンジンで動作します。 高度なPDF生成設定については、レンダリングオプションのガイドを参照してください。
マージンは CSS スタイルとどのように相互作用しますか?
マージンはHTMLのstyleセクションで設定されたものに追加されます。 以下の例では、HTMLマージンは50mmで、RenderingOptionsが30mmを追加し、合計80mmのマージンとなります。
:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins-with-css.csconst 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");Const htmlWithStyle As String = "
<!DOCTYPE html>
<html>
<head>
<style>
body {margin: 50mm 50mm 50mm 50mm;}
</style>
</head>
<body>
<h1>Hello World!</h1>
</body>
</html>"
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.MarginTop = 30
renderer.RenderingOptions.MarginLeft = 30
renderer.RenderingOptions.MarginRight = 30
renderer.RenderingOptions.MarginBottom = 30
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlWithStyle)
pdf.SaveAs("PdfWithCustomMargins.pdf")結果としての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.csrenderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All動的コンテンツとスタイルによるヘッダーとフッターの実装については、ヘッダーとフッターの追加のガイドを参照してください。
ヘッダーとフッターに選択的に余白を適用するにはどうすればよいですか?
ヘッダーとフッターに適用する余白を指定します。 詳細な設定は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;' 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異なるヘッダー/フッターマージン設定はいつ使うべきですか
ヘッダーとフッターの選択的余白設定は、ページ余白が交互にある書籍や、本文は余白を維持しながらヘッダーがページ端まで伸びているような、非対称レイアウトの文書に効果的です。
一般的な使用例
- 書籍出版：内側と外側の余白を交互に綴じる
- レターヘッド文書：全角ヘッダーと制約のある本文
- フォームとテンプレート：フィールドと命令の余白の違い
- 複数カラムのレイアウト：列の余白がある全幅のヘッダー
私のお気に入りのこの種のライブラリはIronPDFです。PDFファイルの迅速で効率的な操作が可能です。また、PDF/A形式へのエクスポートやPDF文書へのデジタル署名といった多くの貴重な機能も備えています。
高度なマージンの考慮事項
改ページと余白を扱う
カスタムマージンは、改ページと相互作用します。 IronPDFは余白の設定を尊重しながらページ間のコンテンツの流れを処理し、複数ページのドキュメントで一貫した書式を保証します。
マージンの単位と精度
IronPDFは余白にミリメートルを使用しています。 他の単位からの変換
- インチ→mm：25.4倍
- mmポイント：0.352778を掛ける
- ピクセル→mm：DPIによって異なります（96 DPIの場合、0.264583を掛けます）。
IronPDFは必要に応じてミリメートル以下の精度の小数値をサポートします。
マージンによるパフォーマンスの最適化
カスタムマージンのある大型ドキュメントの場合：
rendererレベルでマージンを一度設定する 2.類似文書間で一貫した値を使用 3.マージン設定を他のレンダリング オプションと組み合わせてください。
他のIronPDF機能と統合する
カスタムマージンはIronPDFの他の機能とも連動します：
- ウォーターマークとスタンプは境界を尊重します。
- PDF圧縮は整合性を維持します。
- デジタル署名の位置と余白の関係
結論
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 }.
Why are my CSS @page margins ignored, and how do I make them take precedence?
By default IronPDF adds CSS @page margins to your RenderingOptions margins. To choose which wins, set RenderingOptions.CssPageRulePolicy: Default keeps the legacy additive behavior, RenderingOptionsWin strips @page margins and uses your C# margins, and CssPageWin applies the @page margins. It controls margins only, not page size or orientation, and under CssPageWin you should give any header or footer a fixed MaxHeight.
まだスクロールしていますか?
すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。
無料で始めましょう
無料で始めましょう
無料ライブデモを予約
