Jak używać Virtual Viewport i Zoom w IronPDF z C

Czym są tryby dopasowania do papieru w IronPDF?

Uzyskaj dostęp do pola PaperFit w RenderingOptions, aby korzystać z predefiniowanych metod dla określonych typów renderowania i trybów. Te tryby oferują różne podejścia do renderowania treści HTML na stronach PDF, podobne do technik stosowanych podczas tworzenia niestandardowych rozmiarów papieru. Przeanalizujmy każdy tryb PaperFit, renderując główną stronę Wikipedii do porównania.

Tryby PaperFit obsługują różne układy treści, od standardowych stron internetowych po specjalistyczne dokumenty, takie jak pokwitowania czy raporty. Każdy tryb optymalizuje się dla określonych przypadków użycia, zapewniając, że pliki PDF zachowują zamierzony projekt i czytelność bez względu na oryginalny format treści źródłowej.

Jak używam domyślnego renderowania Chrome?

Ten tryb układa strony PDF tak, jak pojawiają się w podglądzie wydruku Google Chrome. Konfiguruje opcje renderowania, aby pasowały do wyglądu strony internetowej przy drukowaniu z Chrome. Responsywny widok CSS interpretuje podany rozmiar papieru na podstawie jego szerokości. Użyj metody UseChromeDefaultRendering, aby to skonfigurować.

Domyślne renderowanie Chrome utrzymuje zgodność z oczekiwaniami drukarki przeglądarki. Działa dobrze dla standardowych stron internetowych i dokumentów, gdy celem jest zachowanie naturalnego przepływu treści, tak jak pojawia się to w typowych operacjach druku przeglądarki. Dla zaawansowanych scenariuszy obejmujących renderowanie JavaScript, ten tryb zapewnia prawidłowe wykonanie i wyświetlanie dynamicznej treści.

: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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering()

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

pdf.SaveAs("chromeDefault.pdf")

Jak używam responsywnego renderowania CSS?

W trybie responsywnego CSS, określ szerokość widoku poprzez przekazanie wartości do metody UseResponsiveCssRendering. Domyślna ViewPortWidth wynosi 1280 pikseli. Jednostka widoku jest oparta na pikselach, reprezentując wirtualny widok przeglądarki dla responsywnych projektów CSS. Ten tryb obsługuje nowoczesne frameworki i współpracuje z układami Bootstrap i Flex CSS.

Responsywne CSS definiuje renderowanie HTML na podstawie parametru ViewPortWidth, skalując treść, aby pasowała do określonej szerokości rozmiaru papieru. To podejście pasuje do nowoczesnych aplikacji internetowych wykorzystujących zasady responsywnego projektowania, zapewniając, że pliki PDF zachowują zamierzony układ bez względu na oryginalną wielkość widoku. Pracując z niestandardowymi marginesami, ten tryb zapewnia precyzyjną kontrolę nad adaptacją treści do różnych wymiarów stron.

: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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280)

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

pdf.SaveAs("responsiveCss.pdf")

Jak używam renderowania skalowanego?

Metoda UseScaledRendering naśladuje zachowanie podglądu wydruku Chrome dla określonego rozmiaru papieru, oferując jednocześnie regulowany poziom zbliżenia. Ta metoda skaluje treść zgodnie z podanym procentem zbliżenia.

Skalowane renderowanie oferuje precyzyjną kontrolę nad wyglądem treści w PDF. W przeciwieństwie do podejść z ustalonym widokiem, ta metoda pozwala na dynamiczną regulację rozmiaru treści, co czyni ją idealną dla dokumentów wymagających czytelności w różnych skalach lub przy przygotowywaniu plików PDF dla różnych kontekstów wyświetlania. Technika ta uzupełnia ustawienia orientacji i obrotu stron dla optymalnej prezentacji dokumentu.

: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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180)

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

pdf.SaveAs("scaled.pdf")

Jak używam renderowania dopasowanego do strony?

Renderowanie dopasowane do strony skaluje treść, aby pasowała do określonego rozmiaru papieru. Mierzy minimalną szerokość treści HTML po renderowaniu i skaluje ją, aby dopasować do szerokości jednej kartki papieru, gdzie to możliwe. Konfigurowalna minimalna szerokość pikseli zapewnia prawidłowe wyświetlanie i responsywność względem zasad układu CSS3.

Ten tryb obsługuje treść, która może rozciągać się poziomo na wiele stron. Działa dobrze dla szerokich tabel, wykresów lub pulpitów nawigacyjnych, które muszą mieścić się w szerokości jednej strony. Automatyczne skalowanie zapewnia, że cała treść pozostaje widoczna bez przewijania poziomego, co czyni go idealnym do generowania raportów PDF, gdzie czytelność ma znaczenie.

: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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering()

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

pdf.SaveAs("fitToPage.pdf")

Jak używam renderowania ciągłego przesuwania?

Renderowanie ciągłego przesuwania tworzy jednolitą stronę PDF, która mieści całą treść na jednej stronie, odpowiednią dla dokumentów, takich jak rachunki konsumenckie lub pokwitowania. Domyślna szerokość strony PDF wynosi 80,0 milimetrów z marginesami 5-milimetrowymi. Wyrenderujmy plik 'receipt.html' do PDF.

Dostosuj szerokość strony i margines za pomocą parametrów width i margin dla elastyczności. Ten tryb tworzy zwięzłe, jedno-stronicowe dokumenty. Generuje pokwitowania, faktury lub jakikolwiek dokument wymagający ciągłego przepływu bez przerw stron. W połączeniu z kontrolą przerw stron HTML do PDF, można tworzyć zaawansowane układy dokumentów zgodnie z konkretnymi wymaganiami.

: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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private width As Integer = 90
Private margin As Integer = 0

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

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("receipt.html")

pdf.SaveAs("continuousFeed.pdf")

Gotowy, aby sprawdzić, co jeszcze można zrobić? Sprawdź stronę z samouczkami tutaj: Konwersja PDF-ów