MaxHeight vs UseMarginToHeaderAndFooter

MaxHeight

MaxHeight legt die maximale Höhe fest, die für die Kopf- oder Fußzeilenabschnitte im gerenderten PDF zugewiesen wird. IronPDF passt diese Höhe standardmäßig dynamisch an, sodass alle Kopf- oder Fußzeileninhalte passen.

Ein manuelles Verringern von MaxHeight führt dazu, dass jeder Inhalt, der den von Ihnen festgelegten Wert überschreitet, abgeschnitten oder ausgeblendet wird. Umgekehrt vergrößert ein zu großer Wert die sichtbare Kopf- oder Fußzeile nicht; IronPDF fällt auf seine Standardgröße zurück, um das Layout stabil zu halten.

UseMarginToHeaderAndFooter

Kopf- und Fußzeilen haben eine eigene Layout-Handhabung, die von den Inhaltsrändern, die über ChromePdfRenderOptions festgelegt wurden, getrennt ist. Für präzise Abstände definieren Sie die Ränder direkt im HTML des Header oder Footer Objekts:

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

Dim renderer = New ChromePdfRenderer()
renderer.RenderingOptions.HtmlHeader = New HtmlHeaderFooter() With {
    .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
}
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>")

Das Gestalten der Kopfzeile in ihrem eigenen HtmlFragment hält die Abstände vorhersehbar, da die Ränder mit dem Inhalt bestehen, auf den sie angewendet werden.

Die Eigenschaft UseMarginToHeaderAndFooter erweitert die Hauptinhaltsränder (wie links und rechts) auf die Kopf- und Fußzeilenabschnitte. Verwenden Sie es sorgfältig: Das Anwenden von vertikalen Rändern (oben und unten) auf diese Weise führt häufig zu überlappenden Inhalten und anderen Überraschungen.

• Empfohlen: Wenden Sie es nur für die linke und rechte Randausrichtung an, wenn Sie es benötigen, oder kombinieren Sie es mit der AddHtmlHeaderFooter() Methode, wenn UseMargins.All erforderlich ist.
• Vermeiden: Verwenden Sie es für obere und untere Ränder, es sei denn, Sie haben das resultierende Layout getestet.