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 Randkonfiguration herunter
- Instanziieren Sie die ChromePdfRenderer klasse zum Rendern von PDF-Dateien
- Ändern Sie die Randwerte im Chrome Renderer's RenderingOptions für Anpassungen
- 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 zunächst die Klasse ChromePdfRenderer. Mit ChromePdfRenderer können Sie auf das Objekt RenderingOptions zugreifen, über das Sie die spezifischen Ränder in Millimetern für oben, unten, links und rechts festlegen können, wie unten dargestellt:
:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins.csChromePdfRenderer 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 = 40Beachten Sie, dass dies zu den Rändern hinzufügt, die im Abschnitt style der HTML-Datei festgelegt sind. Im nachstehenden Beispiel sind die Ränder in der HTML-Datei zunächst auf 50 mm eingestellt, aber durch die Einstellung der Ränder für jede Seite in RenderingOptions werden die Ränder um weitere 30 mm erhöht, so dass sie 80 mm betragen:
:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-set-margins-with-css.csconst 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 werden die in RenderingOptions festgelegten Ränder nicht auf Kopf- und Fußzeilen im Dokument angewendet. Um die gleichen benutzerdefinierten Ränder des Dokuments in den Kopf- und Fußzeilen festzulegen, konfigurieren Sie die Eigenschaft UseMarginsOnHeaderAndFooter in RenderingOptions:
:path=/static-assets/pdf/content-code-examples/how-to/custom-margins-use-margins-header-footer.csrenderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.All;renderer.RenderingOptions.UseMarginsOnHeaderAndFooter = UseMargins.AllSie können festlegen, welche Ränder in der Kopf- und Fußzeile gesetzt werden sollen. Eine vollständige Liste der Enums für die Einstellung von Rändern in Kopf- und Fußzeilen finden Sie in unsererumfassende 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
