Benutzerdefinierte Ränder festlegen

Jordi related to Benutzerdefinierte Ränder festlegen
Jordi Bardia
3. Oktober 2023
Aktualisiert 5. Februar 2025
Teilen Sie:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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.

Erster Schritt:
green arrow pointer



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
$vbLabelText   $csharpLabel

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")
$vbLabelText   $csharpLabel

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
$vbLabelText   $csharpLabel

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
$vbLabelText   $csharpLabel
Jordi related to Benutzerdefinierten Rand in Kopfzeile/Fußzeile festlegen
Software-Ingenieur
Jordi beherrscht vor allem Python, C# und C++. Wenn er seine Fähigkeiten bei Iron Software nicht einsetzt, programmiert er Spiele. Durch seine Mitverantwortung für Produkttests, Produktentwicklung und Forschung trägt Jordi wesentlich zur kontinuierlichen Produktverbesserung bei. Die vielseitigen Erfahrungen, die er sammelt, bieten ihm immer wieder neue Herausforderungen, und er sagt, dass dies einer seiner Lieblingsaspekte bei Iron Software ist. Jordi wuchs in Miami, Florida, auf und studierte Informatik und Statistik an der University of Florida.