Jak używać Virtual Viewport i Zoom w IronPDF z C
Kontroluj obszar widoku i powiększanie w IronPDF, używając właściwości RenderingOptions do ustawienia wartości ViewPortWidth i Zoom lub wykorzystaj wstępnie ustawione tryby PaperFit do automatycznego zarządzania układem podczas konwersji HTML do PDF.
Podczas renderowania z HTML do PDF, widok określa, jak układy stron internetowych są przechwytywane w wynikowym dokumencie PDF. Reprezentuje rozmiar wirtualnego ekranu, który przeglądarka używa do renderowania strony internetowej. Pracując z Silnikiem renderującym Chrome IronPDF, zrozumienie ustawień widoku jest kluczowe dla uzyskania dokładnych wyników.
Zoom kontroluje skalowanie treści strony internetowej w dokumencie PDF. Dostosowanie poziomu zbliżenia reguluje rozmiar treści w PDF, zapewniając właściwy układ i formatowanie. Ta funkcja jest szczególnie przydatna przy obsłudze responsywnych układów CSS, które muszą dostosowywać się do różnych rozmiarów stron.
Szybki start: Kontrola zbliżenia i widoku za pomocą IronPDF
Zarządzaj ustawieniami zbliżenia i widoku w konwersjach HTML do PDF za pomocą IronPDF. Ten przewodnik dostarcza prosty fragment kodu do rozpoczęcia skalowania treści HTML. Za pomocą minimalnej ilości kodu można zapewnić prawidłowe renderowanie PDF przy zachowaniu elementów responsywnego projektu i pożądanych układów.
UseChromeDefaultRendering
UseResponsiveCssRendering
ViewPortWidth
UseScaledRendering
width
margin
-
Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf -
Skopiuj i uruchom ten fragment kodu.
new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } } .RenderUrlAsPdf("https://example.com") .SaveAs("zoomedViewport.pdf"); -
Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
Minimalny proces (5 kroków)
- Pobierz bibliotekę IronPDF C# do renderowania PDF i kontroli widoku
RenderHtmlToPdfuzywajac roznych wstępnie skonfigurowanych trybow- Uzyj trybów
ChromeDefaultiResponsiveCSS, aby osiagnac automatyczne dostosowanie ukladu w PDF - Wykorzystaj skalowanie do zbliżenia treści
- Skonfiguruj 'dopasowanie do strony' i 'ciagle zasilanie' dla okreslonych przypadkow uzycia, korzystajac z
FitToPageiContinuousFeed
Czym są tryby dopasowania do papieru w IronPDF?
Przejdź do pola PaperFit w RenderingOptions, aby skorzystać z gotowych metod dla określonych typów i trybów renderowania. 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 stronę główną Wikipedii w celu 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. Aby to skonfigurować, użyj metody ChromeDefaultRendering.
Domyślne renderowanie Chrome utrzymuje zgodność z oczekiwaniami drukarki przeglądarki. Działa dobrze dla standardowych stron internetowych i dokumentów, gdzie chcesz zachować naturalny przepływ 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ść okna wyświetlania, przekazując wartość do metody SetWidth. Domyślna wartość Width 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.
Responsywny CSS definiuje renderowanie HTML na podstawie parametru ViewPortWidth, skalując zawartość tak, aby dopasować ją do określonej szerokości formatu 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 SetScaledRendering naśladuje zachowanie podglądu wydruku w przeglądarce Chrome dla określonego rozmiaru papieru, zapewniając jednocześnie regulowany poziom Zoom. 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.
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. Let's render the 'receipt.html' file to PDF.
Aby zapewnić elastyczność, dostosuj szerokość strony i marginesy za pomocą parametrów SetPageWidth i SetMargins. 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żesz zrobić? Sprawdź naszą stronę z samouczkami tutaj: Konwersja PDF-ów
Często Zadawane Pytania
Czym jest viewport w konwersji HTML do PDF?
W IronPDF viewport reprezentuje wirtualny rozmiar ekranu, którego silnik renderowania Chrome używa do renderowania stron webowych przed ich konwersją na PDF. Określa, jak układy stron internetowych są odwzorowywane w powstałym dokumencie PDF, co jest kluczowe dla uzyskania dokładnych wyników renderowania.
Jak mogę kontrolować zoom i szerokość viewportu za pomocą jednej linijki kodu?
Możesz kontrolować zarówno szerokość viewportu, jak i zoom w IronPDF, używając jednej linijki: new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }.RenderUrlAsPdf('https://example.com').SaveAs('zoomedViewport.pdf'). To ustawia viewport na 1280 pikseli i stosuje współczynnik zoomu 1.8x.
Czym są tryby PaperFit?
Tryby PaperFit w IronPDF to predefiniowane metody, dostępne poprzez pole RenderingOptions.PaperFit, które oferują różne podejścia do renderowania treści HTML na stronach PDF. Każdy tryb optymalizuje dla specyficznych zastosowań, takich jak standardowe strony webowe, paragony czy raporty, zapewniając, że pliki PDF zachowują zamierzony projekt i czytelność.
Dlaczego kontrola zoomu jest ważna dla responsywnych układów CSS?
Kontrola zoomu w IronPDF jest szczególnie przydatna przy przetwarzaniu responsywnych układów CSS, które muszą dostosować się do różnych rozmiarów stron. Dostosowanie poziomu zoomu reguluje wielkość treści w PDF, zapewniając odpowiedni układ i formatowanie oraz zachowując elementy responsywnego projektu.
Jaki silnik renderowania wykorzystuje funkcje viewportu i zoomu?
Funkcje viewportu i zoomu w IronPDF korzystają z silnika renderowania Chrome. Zapewnia to, że strony internetowe są renderowane dokładnie i spójnie, tak jak by były wyświetlane w Google Chrome przed konwersją na PDF.
Czym jest tryb Chrome Default Rendering?
Chrome Default Rendering to tryb PaperFit w IronPDF, który układa strony PDF tak, jak wyglądają w podglądzie wydruku Google Chrome. Konfiguruje opcje renderowania w taki sposób, aby pasowały do wyglądu strony internetowej drukowanej z Chrome, interpretując responsywny viewport CSS na podstawie określonego rozmiaru papieru.

