MaxHeight vs UseMarginToHeaderAndFooter

Curtis Chau

Updated: 2026年6月29日

在渲染带有页眉和页脚的PDF时，两个属性通常会混淆：MaxHeight 和 UseMarginToHeaderAndFooter。它们控制不同的东西，混淆它们会导致内容被剪切或意外重叠。以下是每个属性的功能及何时使用的说明。

MaxHeight

MaxHeight 设置在渲染的PDF中分配给页眉或页脚部分的最大高度。默认情况下，IronPDF会动态调整此高度，以便所有页眉或页脚内容都能适应。

手动降低 MaxHeight 会剪切或隐藏任何超过您设置值的内容。反之，一个过大的值不会放大可见的页眉或页脚； IronPDF会恢复其默认尺寸以保持布局稳定。

MaxHeight设为10的渲染PDF，页眉文本被剪切

MaxHeight设为15的渲染PDF，页眉文本部分被剪切

MaxHeight设为50的渲染PDF，显示完整的页眉

MaxHeight设为100的渲染PDF，显示与默认尺寸相同

请注意: MaxHeight不会在页眉或页脚与主文档内容之间添加任何边距。它仅限制节高。

UseMarginToHeaderAndFooter

页眉和页脚具有自己的布局处理，与通过 ChromePdfRenderOptions 设置的内容边距分开。为了精确控制间距，请直接在 Header 或 Footer 对象的HTML中定义边距。

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style=""margin-top: 20px; margin-right: 40px; margin-bottom: 10px; margin-left: 30px; background-color: lightblue;"">
   This is Header
  </div>",
  DrawDividerLine = true,
  MaxHeight = 30
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = @"<div style=""margin-top: 20px; margin-right: 40px; margin-bottom: 10px; margin-left: 30px; background-color: lightblue;"">
   This is Header
  </div>",
  DrawDividerLine = true,
  MaxHeight = 30
};
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

在其自身的 HtmlFragment 中样式化页眉使间距保持可预测，因为边距与它们应用的内容一起存活。

UseMarginToHeaderAndFooter 属性将主要内容边距（例如左和右）扩展到页眉和页脚部分。小心使用：这种方式应用垂直边距（上下）往往会产生重叠内容和其他意外。