IRONSOFTWAREHOME

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

Curtis Chau
Curtis Chau
Updated: 22 kwietnia 2026

Kontroluj okno i powiększenie w IronPDF, używając właściwości RenderingOptions do ustawienia wartości ViewPortWidth i Zoom lub korzystaj z predefiniowanych trybów 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

  1. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. 2Skopiuj i uruchom ten fragment kodu.

    new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
        .RenderUrlAsPdf("https://example.com")
        .SaveAs("zoomedViewport.pdf");
    C#
  3. 3Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
    arrow pointer

Czym są tryby dopasowania do papieru w IronPDF?

Skorzystaj z 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. Przyjrzyjmy się każdemu trybowi PaperFit, renderując stronę główną Wikipedii dla 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 ChromeDefaultRendering, aby to skonfigurować.

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.

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

Jak używam responsywnego renderowania CSS?

W trybie CSS responsywnego określ szerokość okna, przekazując wartość do metody SetWidth. Domyślnie 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.

CSS responsywne definiuje renderowanie HTML na podstawie parametru ViewPortWidth, skalując treść do dopasowania do określonej szerokości 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.

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

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak używam renderowania skalowanego?

Metoda SetScaledRendering imituje zachowanie Chrome Print Preview dla określonej wielkości papieru, jednocześnie zapewniając regulowany poziom powiększenia. 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.

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

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.

Dostosuj szerokość strony i margines, używając parametrów SetPageWidth i SetMargins 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.

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

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.

Curtis Chau
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543Wersja:2026.7właśnie wydany

Odbierz swój BEZPŁATNY

30-dniowy klucz próbny natychmiast.

bullet_checkedNie wymaga karty kredytowej ani tworzenia konta
test_punktorówTestuj w produkcji
bez znaków wodnych
kalendarz_punktorów30 dni w pełni
funkcjonalny produkt
wsparcie_punktorów24/5 wsparcie techniczne
w trakcie okresu próbnego
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka C# NuGet dla plików PDF
Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
  2. Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
  3. Wybierz pakiet i zainstaluj
DLL PDF dla C#
Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

  1. Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
  2. W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta