Hochformat- & Querformatausrichtung

VB C#

using IronPdf;

// For NEW PDF Documents use PdfPaperOrientation
// PdfPaperOrientation: To choose Landscape or Portrait Orientation in a new PDF document
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;

var newPdfFromHtml = renderer.RenderHtmlAsPdf("<h1> Hello World! </h1>");
var newPdfFromHtmlFile = renderer.RenderHtmlFileAsPdf("example.html");
var newPdfFromUrl = renderer.RenderUrlAsPdf("https://ironpdf.com");


// For EXISTING PDFs use PageRotation
// PageRotation : To rotate a PDF page and all of its  its contents
var existingPdf = new PdfDocument("old_report.pdf");

// Get rotation value
var getRotationFirstPage = existingPdf.Pages[0].PageRotation;

// Rotate specified page
existingPdf.SetPageRotation(PageIndex: 0, Rotation: IronPdf.Rendering.PdfPageRotation.Clockwise90);

// Rotate ALL pages
existingPdf.SetAllPageRotations(IronPdf.Rendering.PdfPageRotation.Clockwise270);

Install-Package IronPdf

Hochformat- & Querformatausrichtung

Beim Erstellen dynamischer PDF-Dokumente kommt es häufig vor, dass die Ausrichtung des Dokuments angepasst werden muss. Hier kommt PaperOrientation von IronPDF ins Spiel. Dieses Tool ermöglicht Entwicklern den Zugriff auf die Klasse PdfPaperOrientation . Damit können Sie beim Rendern von PDF-Dokumenten aus HTML- oder URL-Inhalten zwischen Quer- und Hochformat wählen.

Für die Ausrichtung im Querformat verwenden Sie: PdfPaperOrientation.Landscape

Für die Ausrichtung im Hochformat verwenden Sie: PdfPaperOrientation.Portrait

Wenn Sie mit bereits vorhandenen PDF-Dokumenten arbeiten, können Sie die PageRotation verwenden, um die Ausrichtung des PDF-Dokuments anzupassen. Um die Seitenrotation in Ihrem Dokument festzulegen, gehen Sie wie folgt vor:

Verwenden Sie SetPageRotation wenn Sie eine bestimmte Seite innerhalb der PDF-Datei drehen möchten.

Verwenden Sie SetAllPageRotations wenn Sie alle Seiten in Ihrem PDF-Dokument drehen möchten.

5 Schritte zum Einstellen der PDF-Seitenausrichtung

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
var newPdfFromHtml = renderer.RenderHtmlAsPdf("<h1> Hello World! </h1>");
var existingPdf = new PdfDocument("old_report.pdf");
existingPdf.SetPageRotation(0, PdfPageRotation.Clockwise90);

Zunächst müssen wir entscheiden, ob wir ein bestehendes PDF-Dokument verwenden oder ein neues erstellen. Schauen wir uns zunächst die Schritte zum Festlegen der Ausrichtung eines neu gerenderten PDF-Dokuments an und anschließend, wie dies bei einem bereits vorhandenen PDF funktioniert.

Zuerst müssen Sie eine neue ChromePdfRenderer() Instanz erstellen. Hiermit wird die Erstellung eines neuen PDF-Dokuments aus HTML- oder URL-Inhalten übernommen. Als nächstes wird vor dem Rendern die Papierausrichtung mit renderer.RenderingOptions.PaperOrientation festgelegt. Durch die Auswahl von PdfPaperOrientation.Landscape wird die generierte PDF-Datei im Querformat anstatt im standardmäßigen Hochformat angezeigt. Wir verwenden die Rendering-Methode RenderHtmlAsPdf , die eine HTML-Zeichenkette entgegennimmt und diese sofort in ein PDF umwandelt.

Schauen wir uns nun an, wie Sie eine benutzerdefinierte Ausrichtung für bestehende PDF-Dokumente festlegen können. Zuerst laden wir eine Datei namens old_report.pdf in ein PdfDocument Objekt, um Zugriff auf deren Seiten zu erhalten. Mit Pages[0].PageRotation können Sie den Rotationsstatus der ersten Seite überprüfen. Um Änderungen vorzunehmen, dreht SetPageRotation eine einzelne Seite, in diesem Fall Seite eins um 90 Grad im Uhrzeigersinn.

Zusammengenommen veranschaulichen diese Beispiele, wie IronPDF nicht nur ansprechende PDFs aus HTML- und Webquellen erstellt, sondern auch leistungsstarke Werkzeuge zur Anpassung der Seitenausrichtung und -drehung in bestehenden PDF-Dokumenten bereitstellt und so die PDF-Workflows für .NET-Entwickler optimiert.

Erfahren Sie mehr über Seitenausrichtung und Drehung in PDFs.

Auf GitHub ansehen

Code

https://github.com/iron-software/IronPdf.Examples/tree/main/examples/pdf-page-orientation

ZIP herunterladen