カスタムの余白を設定する方法

Translated

View the article in English

によってジョルディ・バルディア

PDFやその他のドキュメントを扱う際、異なる標準に従うために余白を指定する必要があることがよくあります。例えば、MLAやAPA形式では両方とも1インチの余白が必要ですが、一部の大学では論文のために1.5インチの余白が必要な場合があります。

IronPDFは、HTMLからPDFをレンダリングする際にカスタムマージンを簡単に設定することができます。必要なのは、いくつかの簡単な設定だけです。

IronPDFを始めましょう

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:

カスタムの余白を設定する方法

IronPDF C#ライブラリをダウンロードしてマージン設定を行う
インスタンス化する ChromePdfRenderer（クロームPDFレンダラー） PDFファイルをレンダリングするためのクラス
Chrome Rendererでマージン値を修正する レンダリングオプション カスタマイズ用
ヘッダーとフッターに特化した余白の調整
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;

Dim renderer As New ChromePdfRenderer()

renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40

VB C#

これは、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");

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")

VB C#

以下に生成された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;

renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All

VB C#

ヘッダーとフッターに設定する余白を指定することが可能です。ヘッダーとフッターのマージンを設定するための列挙型の完全なリストについては、こちらをご覧ください包括的な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;

' 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

VB C#

ジョルディ・バルディア

ソフトウェアエンジニア

ジョルディは、Iron Softwareでのスキルを活かしていないときには、ゲームプログラミングをしており、Python、C#、C++に最も堪能です。彼は製品テスト、製品開発、研究の責任を共有しており、継続的な製品改善に大きな価値をもたらしています。この多様な経験は彼を常に挑戦的で魅力的に保ち、彼はIron Softwareで働く一番好きな側面の一つだと言っています。ジョルディはフロリダ州マイアミで育ち、フロリダ大学でコンピューターサイエンスと統計学を学びました。