Wie man C#35; Virtual Viewport und Zoom in IronPDF verwendet

Was sind die Papiereinpassungsmodi in IronPDF?

Greifen Sie auf das Feld PaperFit in RenderingOptions zu, um voreingestellte Methoden für bestimmte Rendering-Typen und -Modi zu verwenden. Diese Modi bieten verschiedene Ansätze für das Rendern von HTML-Inhalten auf PDF-Seiten, ähnlich den Techniken, die bei der Erstellung benutzerdefinierter Papiergrößen verwendet werden. Schauen wir uns jeden PaperFit-Modus an, indem wir die Wikipedia-Hauptseite zum Vergleich wiedergeben.

Die PaperFit-Modi verarbeiten verschiedene Inhaltslayouts, von Standard-Webseiten bis hin zu speziellen Dokumenten wie Quittungen oder Berichten. Jeder Modus ist für bestimmte Anwendungsfälle optimiert und stellt sicher, dass die PDFs das beabsichtigte Design und die Lesbarkeit unabhängig vom ursprünglichen Format des Quellinhalts beibehalten.

Wie verwende ich das Standard-Rendering von Chrome?

In diesem Modus werden PDF-Seiten so dargestellt, wie sie in der Druckvorschau von Google Chrome erscheinen. Sie konfiguriert die Rendering-Optionen so, dass sie dem Erscheinungsbild einer Webseite entsprechen, wenn diese von Chrome aus gedruckt wird. Der responsive CSS-Viewport interpretiert die angegebene Papiergröße auf der Grundlage ihrer Breite. Verwenden Sie die Methode UseChromeDefaultRendering, um dies zu konfigurieren.

Das Standard-Rendering von Chrome sorgt für Konsistenz mit den Erwartungen an den Browserdruck. Sie eignet sich gut für Standard-Webseiten und -Dokumente, bei denen der natürliche Inhaltsfluss, wie er in typischen Browser-Druckvorgängen erscheint, erhalten bleiben soll. Für fortgeschrittene Szenarien, die JavaScript-Rendering beinhalten, gewährleistet dieser Modus die korrekte Ausführung und Anzeige dynamischer Inhalte.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-default-chrome.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("chromeDefault.pdf");

Wie verwende ich Responsive CSS Rendering?

Im responsiven CSS-Modus geben Sie eine Darstellungsbreite an, indem Sie einen Wert an die Methode UseResponsiveCssRendering übergeben. Die Standard-ViewPortWidth ist 1280 Pixel. Die Viewport-Einheit ist pixelbasiert und stellt ein virtuelles Browser-Viewport für responsive CSS-Designs dar. Dieser Modus beherrscht moderne Frameworks und funktioniert mit Bootstrap und Flex CSS-Layouts.

Responsive CSS definiert das HTML-Rendering auf der Grundlage des Parameters ViewPortWidth, der den Inhalt so skaliert, dass er auf die angegebene Breite des Papierformats passt. Dieser Ansatz eignet sich für moderne Webanwendungen, die responsive Design-Prinzipien verwenden und sicherstellen, dass PDFs unabhängig von der Größe des ursprünglichen Ansichtsfensters das beabsichtigte Layout beibehalten. Bei der Arbeit mit Benutzerdefinierten Rändern bietet dieser Modus eine präzise Kontrolle über die Anpassung des Inhalts an unterschiedliche Seitengrößen.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-responsive-css.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("responsiveCss.pdf");

Wie verwende ich Scaled Rendering?

Die Methode UseScaledRendering ahmt das Verhalten der Chrome-Druckvorschau für eine bestimmte Papiergröße nach und bietet eine einstellbare Zoomstufe. Bei dieser Methode wird der Inhalt entsprechend dem eingegebenen Zoom-Prozentsatz skaliert.

Das skalierte Rendering bietet eine präzise Kontrolle über die Darstellung von Inhalten in PDFs. Im Gegensatz zu Ansätzen mit festem Ansichtsfenster ermöglicht diese Methode eine dynamische Anpassung der Inhaltsgröße, was sie ideal für Dokumente macht, die in verschiedenen Maßstäben lesbar sein müssen, oder wenn PDFs für verschiedene Anzeigekontexte vorbereitet werden. Diese Technik ergänzt die Seitenausrichtung und -drehung-Einstellungen für eine optimale Darstellung des Dokuments.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-scaled.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("scaled.pdf");

Wie verwende ich Fit to Page Rendering?

Fit to page rendering skaliert den Inhalt so, dass er auf die angegebene Papiergröße passt. Es misst die minimale Breite des HTML-Inhalts nach dem Rendering und skaliert ihn so, dass er nach Möglichkeit auf ein Blatt Papierbreite passt. Die konfigurierbare Mindestpixelbreite gewährleistet die korrekte Anzeige und die Einhaltung der CSS3-Layoutregeln.

In diesem Modus werden Inhalte bearbeitet, die sich horizontal über mehrere Seiten erstrecken können. Sie eignet sich gut für breite Tabellen, Diagramme oder Dashboards, die in eine einzige Seitenbreite passen müssen. Die automatische Skalierung sorgt dafür, dass der gesamte Inhalt ohne horizontales Scrollen sichtbar bleibt, und ist somit ideal für die Erstellung von PDF-Berichten, bei denen es auf Lesbarkeit ankommt.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-fit-to-page.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("fitToPage.pdf");

Wie verwende ich Continuous Feed Rendering?

Beim Continuous Feed Rendering wird eine einseitige PDF-Datei erstellt, bei der der gesamte Inhalt auf eine Seite passt, was sich für Dokumente wie Rechnungen oder Quittungen eignet. Die Standard-PDF-Seitenbreite beträgt 80,0 Millimeter mit 5 Millimeter breiten Rändern. Let's render the 'receipt.html' file to PDF.

Passen Sie die Seitenbreite und den Seitenrand mit den Parametern Breite und Rand flexibel an. In diesem Modus werden prägnante, einseitige Dokumente erstellt. Sie erstellt Quittungen, Rechnungen oder andere Dokumente, die einen kontinuierlichen Fluss ohne Seitenumbrüche erfordern. In Kombination mit HTML to PDF page break control können Sie anspruchsvolle Dokumentenlayouts für spezifische Anforderungen erstellen.

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-continuous-feed.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

int width = 90;
int margin = 0;

// Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderHtmlFileAsPdf("receipt.html");

pdf.SaveAs("continuousFeed.pdf");

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich unsere Tutorial-Seite hier an: PDFs konvertieren