MaxHeight vs UseMarginToHeaderAndFooter

Curtis Chau

Updated: 29 czerwca 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Podczas renderowania PDF z nagłówkami i stopkami, dwa właściwości często są mieszane: MaxHeight i UseMarginToHeaderAndFooter. Kontrolują one różne rzeczy, a ich mieszanie prowadzi do przycinania treści lub nieoczekiwanych pokryć. Oto, co każda z nich robi i kiedy warto ją zastosować.

MaxHeight

MaxHeight ustawia maksymalną wysokość przydzieloną dla sekcji nagłówka lub stopki w renderowanym PDF. Domyślnie, IronPDF dostosowuje tę wysokość dynamicznie, aby zmieścić całą zawartość nagłówka lub stopki.

Ręczne obniżenie MaxHeight przycina lub ukrywa wszelkie treści przekraczające ustawioną wartość. Przy większej wartości widoczny nagłówek lub stopka nie są powiększane; IronPDF przywraca domyślne rozmiary, aby utrzymać stabilność układu.

UseMarginToHeaderAndFooter

Nagłówki i stopki mają własną obsługę układu, oddzielną od marginesów treści ustawionych przez ChromePdfRenderOptions. Dla precyzyjnego rozmieszczenia, zdefiniuj marginesy bezpośrednio w HTML obiektu Header lub Footer:

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

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

Stylizacja nagłówka we własnym HtmlFragment zapewnia przewidywalne rozmieszczenie, ponieważ marginesy są związane z treścią, do której są stosowane.

Właściwość UseMarginToHeaderAndFooter rozszerza główne marginesy treści (takie jak lewe i prawe) na sekcje nagłówka i stopki. Stosuj ją ostrożnie: stosowanie pionowych marginesów (góra i dół) w ten sposób często powoduje nakładające się treści i inne niespodzianki.

• Zalecane: Stosuj tylko dla wyrównania marginesów lewego i prawego, gdy jest to konieczne, lub łącz to z metodą AddHtmlHeaderFooter(), gdy UseMargins.All jest wymagane.
• Unikaj: Stosowania dla marginesów górnych i dolnych, chyba że przetestowałeś wynikowy układ.

Curtis Chau

Autor tekstów technicznych

Czat z zespołem inżynierów teraz

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

Czytaj więcej