Benutzerdefinierte Ränder festlegen
Bei der Arbeit mit PDFs oder anderen Dokumenttypen ist es oft notwendig, die Ränder anzugeben, um unterschiedliche Standards einzuhalten. Die Formate MLA und APA verlangen beispielsweise beide ein 1-Zoll-Format, während einige Universitäten für Dissertationen 1,5-Zoll-Ränder vorschreiben können.
IronPDF macht es einfach, benutzerdefinierte Ränder festzulegen, wenn ein PDF aus HTML gerendert wird - es ist nur eine einfache Konfiguration erforderlich.
Erste Schritte mit IronPDF
Beginnen Sie noch heute mit der Verwendung von IronPDF in Ihrem Projekt mit einer kostenlosen Testversion.
Benutzerdefinierte Ränder festlegen
- Laden Sie die IronPDF C#-Bibliothek für die Randeinstellung herunter
- Instanziieren Sie die ChromePdfRenderer-Klasse, um die PDF-Datei zu rendern
- Ändern Sie die Randwerte in den RenderingOptions des Chrome-Renderers zur Anpassung
- Ränder speziell für Kopf- und Fußzeilen anpassen
- Rendering des HTML in PDF und Speichern des Dokuments
Benutzerdefinierte Marge festlegen Beispiel
Um benutzerdefinierte Ränder festzulegen, instanziieren Sie zuerst die ChromePdfRenderer-Klasse. Mit ChromePdfRenderer können Sie auf das RenderingOptions-Objekt zugreifen, aus dem Sie die spezifischen Ränder in Millimetern für oben, unten, links und rechts festlegen können, wie unten gezeigt:
: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
Beachten Sie, dass dies zu den Rändern hinzukommt, die im style-Abschnitt des HTML festgelegt sind. Zum Beispiel sind in dem untenstehenden Beispiel die Ränder im HTML zunächst auf 50 mm festgelegt, aber das Festlegen der Ränder für jede Seite in RenderingOptions fügt den Rändern weitere 30 mm hinzu, sodass sie 80 mm betragen:
: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")
Die resultierende PDF-Datei ist unten abgebildet:
Benutzerdefinierten Rand in Kopfzeile/Fußzeile festlegen
Standardmäßig gelten die im RenderingOptions festgelegten Ränder nicht für Kopf- und Fußzeilen im Dokument. Um dieselben benutzerdefinierten Ränder des Dokuments in den Kopf- und Fußzeilen festzulegen, konfigurieren Sie die UseMarginsOnHeaderAndFooter-Eigenschaft in RenderingOptions:
: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
Sie können festlegen, welche Ränder in der Kopf- und Fußzeile gesetzt werden sollen. Für eine vollständige Liste der Enumerationen zur Festlegung von Rändern in Kopf- und Fußzeilen werfen Sie einen Blick auf unsere umfassende API-Referenz. Nachfolgend sind einige Beispiele für die Festlegung der Ränder zu sehen:
: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