カスタムの余白を設定する方法
PDFやその他のドキュメントを扱う際、異なる標準に従うために余白を指定する必要があることがよくあります。 例えば、MLAやAPA形式では両方とも1インチの余白が必要ですが、一部の大学では論文のために1.5インチの余白が必要な場合があります。
IronPDFは、HTMLからPDFをレンダリングする際にカスタムマージンを簡単に設定することができます。必要なのは、いくつかの簡単な設定だけです。
IronPDFを始めましょう
今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。
カスタムの余白を設定する方法
- マージン設定のためのIronPDF C#ライブラリをダウンロード
- PDFファイルをレンダリングするためにChromePdfRendererクラスをインスタンス化します
- Chrome Renderer の RenderingOptions で余白の値をカスタマイズに合わせて変更
- ヘッダーとフッターのために特定の余白を調整する
- HTMLをPDFにレンダリングして文書を保存する
カスタムマージン設定例
カスタムマージンを設定するには、まずChromePdfRendererクラスをインスタンス化します。 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;
これは、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");
以下に生成されたPDFを示します:
ヘッダー/フッターでカスタムマージンを設定
デフォルトでは、RenderingOptionsで設定された余白は、ドキュメントのヘッダーおよびフッターには適用されません。 ヘッダーおよびフッターのドキュメントに同じカスタム余白を設定するには、RenderingOptionsのUseMarginsOnHeaderAndFooterプロパティを構成します。
:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.cs
renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;
ヘッダーとフッターに設定する余白を指定することが可能です。 ヘッダーとフッターのマージン設定のための列挙型の完全なリストについては、私たちの包括的なAPIリファレンスをご覧ください。 以下は、設定する余白を指定する例です:
: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;