如何在 C# 中使用虛擬視窗和縮放

如何在IronPDF中使用C#虛擬視口和縮放

This article was translated from English: Does it need improvement?
Translated
View the article in English

在IronPDF中,通過使用PaperFit模式,在HTML轉換為PDF時自動處理佈局。

在HTML轉PDF渲染中,視口決定了如何在最終的PDF文件中捕捉網頁佈局。 它代表了瀏覽器用來渲染網頁的虛擬螢幕大小。 當使用IronPDF的Chrome渲染引擎時,理解視口設置是獲得準確結果的關鍵。

縮放控制PDF文件中網頁內容的縮放比例。 微調縮放級別可以調整PDF中的內容大小,確保適當的佈局和格式。 當處理需要適應不同頁面大小的響應式CSS佈局時,此功能特別有用。

快速入門:使用IronPDF控制縮放和視口

使用IronPDF為您的HTML轉PDF轉換管理縮放和視口設置。 本指南提供了一個簡單的程式碼片段來開始縮放HTML內容。 使用最少的程式碼,您可以確保PDF在渲染時保持響應式設計元素和預期的佈局。

UseChromeDefaultRendering UseResponsiveCssRendering ViewPortWidth UseScaledRendering width margin

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 複製並運行這段程式碼片段。

    new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
        .RenderUrlAsPdf("https://example.com")
        .SaveAs("zoomedViewport.pdf");
  3. 部署以在您的實時環境中測試

    今天就開始在您的專案中使用IronPDF,透過免費試用

    arrow pointer


什麼是IronPDF中的紙張適配模式?

PaperFit字段以使用特定渲染型別和模式的預設方法。 這些模式提供不同的方法來將HTML內容渲染到PDF頁面,就像在建立自定義紙張大小時使用的技術。 讓我們通過渲染維基百科首頁來比較每個PaperFit模式。

紙張適配模式處理各種內容佈局,從標準網頁到專門的文件,如收據或報告。 每個模式針對特定用例進行優化,確保PDF能夠保持預期的設計和可讀性,無論原始格式為何。

Icon Quote related to 什麼是IronPDF中的紙張適配模式?

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能,例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic related to 什麼是IronPDF中的紙張適配模式?

Milan Jovanovic

Microsoft MVP

查看案例研究
Icon Quote related to 什麼是IronPDF中的紙張適配模式?

IronOCR意味著我們每年可以從手動處理中節省$40,000,同時提高生產力,釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle related to 什麼是IronPDF中的紙張適配模式?

Brent Matzelle

首席技術官,OPYN

查看案例研究
Icon Quote related to 什麼是IronPDF中的紙張適配模式?

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones related to 什麼是IronPDF中的紙張適配模式?

David Jones

首席軟體工程師,Agorus Build

查看案例研究

如何使用Chrome預設渲染?

此模式將PDF頁面佈局為Google Chrome列印預覽中顯示的樣式。 它配置渲染選項以匹配從Chrome列印時網頁的外觀。 響應式CSS視口根據其寬度解釋指定的紙張大小。 使用ChromeDefaultRendering方法來配置這一點。

Chrome預設渲染保持與瀏覽器列印一致的預期。 它適用於標準的網頁和文件,當您希望保留自然內容流,如在典型瀏覽器列印操作中顯示的內容時。 對於涉及JavaScript渲染的高級場景,此模式確保動態內容的正確執行和顯示。

: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")
$vbLabelText   $csharpLabel

如何使用響應式CSS渲染?

在響應式CSS模式中,通過將值傳遞給SetWidth方法來指定視口寬度。 預設Width為1280像素。 視口單位是基於像素的,代表響應式CSS設計的虛擬瀏覽器視口。 此模式處理現代框架,並可與Bootstrap和Flex CSS佈局一起使用。

響應式CSS基於ViewPortWidth參數定義HTML渲染,按比例縮放內容以適應指定的紙張大小寬度。 此方法適合使用響應式設計原則的現代Web應用程式,確保PDF能夠保持預期的佈局,無論原始視口大小如何。當使用自定義邊距時,這種模式能夠精確控制內容適應不同頁面尺寸。

: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")
$vbLabelText   $csharpLabel

如何使用縮放渲染?

SetScaledRendering方法模仿Chrome 列印預覽行為指定的紙張大小,同時提供可調節的縮放級別。 此方法根據輸入的縮放百分比縮放內容。

縮放渲染對PDF中文件外觀提供精確控制。 與固定視口方法不同,這種方法允許動態內容大小調整,適用於需要在不同縮放比例下可讀性的文件或準備用於各種顯示上下文的PDF。 此技術補充用於最佳文件呈現的頁面方向和旋轉設置。

: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")
$vbLabelText   $csharpLabel

如何使用適應頁面渲染?

適應頁面渲染縮放內容以適應指定的紙張大小。它在渲染後測量最小的HTML內容寬度,並將其縮放以在可能的情況下適應一張紙的寬度。 可配置的最小像素寬度確保顯示正確並響應CSS3佈局規則。

此模式處理可能橫跨多個頁面的內容。 它適用於寬表格、圖表或必須適應單頁寬度的儀表板。 自動縮放確保所有內容都能在不橫向滾動的情況下可見,這使其非常適合生成PDF報告,在這裡可讀性非常重要。

如何使用連續輸入渲染?

連續輸入渲染建立一個單頁PDF,將所有內容適應於一頁,非常適合如消費者帳單或收據之類的文件。預設PDF頁面寬度為80.0毫米,邊距為5毫米。 讓我們渲染receipt.html文件到PDF。

使用SetMargins參數自定義頁面寬度和邊距,以便靈活性。 此模式建立簡潔的單頁文件。 它生成收據、發票或需要連續流無需分頁的任何文件。 結合HTML到PDF的頁面中斷控制,您可以建立適合特定需求的複雜文件佈局。

: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")
$vbLabelText   $csharpLabel

準備好瞭解您還可以做什麼嗎? 在這裡查看我們的教程頁面:轉換PDFs

常見問題

何謂 HTML 到 PDF 轉換中的視窗(viewport)?

在 IronPDF 中,視窗代表 Chrome 渲染引擎在將網頁轉換為 PDF 前使用的虛擬螢幕大小。它決定了網頁佈局如何在結果的 PDF 文件中被捕獲,這對於實現精確的渲染結果至關重要。

如何在一行程式碼中控制縮放和視窗寬度?

您可以在 IronPDF 中使用單行程式碼控制視窗寬度和縮放:new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }.RenderUrlAsPdf('https://example.com').SaveAs('zoomedViewport.pdf')。這將視窗設為1280像素並應用1.8倍的縮放因數。

什麼是 PaperFit 模式?

IronPDF 中的 PaperFit 模式是一組透過 RenderingOptions.PaperFit 欄位存取的預設方法,它提供了在將 HTML 內容渲染到 PDF 頁面的不同方法。每種模式都為特定的用途(如標準網頁、發票或報告)進行最佳化,確保 PDF 保持預期的設計和可讀性。

為何縮放控制對於響應式 CSS 佈局如此重要?

IronPDF 中的縮放控制在處理必須適應不同頁面尺寸的響應式 CSS 佈局時特別有用。精確調整縮放等級可調整 PDF 中的內容大小,確保適當的佈局和格式,同時保持響應式設計元素的效果。

視窗和縮放功能使用什麼渲染引擎?

IronPDF 中的視窗和縮放功能運用了 Chrome 的渲染引擎。這確保了網頁在轉換為 PDF 前能被準確且一致地渲染,與其在 Google Chrome 中的顯示效果一致。

什麼是 Chrome 預設渲染模式?

Chrome 預設渲染是 IronPDF 中的一個 PaperFit 模式,它將 PDF 頁面設計成如同在 Google Chrome 的列印預覽中顯示的那樣。它配置渲染選項以匹配網頁在 Chrome 列印時的外觀,根據指定的紙張大小解讀響應式 CSS 視窗。

Curtis Chau
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位,專精於前端開發,擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面,喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發,Curtis對物聯網(IoT)有濃厚的興趣,探索創新的方法來整合硬體和軟體。在空閒時間,他喜歡玩遊戲和建立Discord機器人,結合他對技術的熱愛與創造力。

準備開始了嗎?
Nuget 下載 19,936,792 | 版本: 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎?

想快速獲得證明嗎? PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。