1. IronPDF
  2. 操作指南
  3. 適合紙張和縮放
如何在 C# 中使用虛擬視窗和縮放

如何在IronPDF中使用 C# 控制HTML轉PDF的虛擬視窗和縮放功能

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

透過使用 RenderingOptions 屬性來設定 ViewPortWidth 和 Zoom 值，或利用預設的 PaperFit 模式在 HTML 到IronPDF轉換期間自動進行佈局處理，來控制 IronPDF 中的視窗和縮放。

在 HTML 轉 PDF 渲染過程中，視口決定了網頁版面如何在產生的 PDF 文件中體現。 它代表瀏覽器用於渲染網頁的虛擬螢幕尺寸。 在使用IronPDF 的 Chrome 渲染引擎時，了解視窗設定對於獲得準確的結果至關重要。

縮放功能控制 PDF 文件中網頁內容的縮放比例。 微調縮放等級可以調整 PDF 中的內容大小，確保佈局和格式正確。 在處理必須適應不同頁面尺寸的響應式 CSS 佈局時，此功能尤其有用。

快速入門：使用IronPDF控制縮放和視窗

使用IronPDF管理 HTML 轉 PDF 轉換中的縮放和視窗設定。 本指南提供了一個簡單的程式碼片段，用於開始擴展 HTML 內容。 只需編寫少量程式碼，即可確保 PDF 正確渲染，同時保持響應式設計元素和所需的佈局。

  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

最簡工作流程(5個步驟)

  1. 下載IronPDF C# 庫，用於 PDF 渲染和視口控制。
  2. 使用不同的預先配置模式將 HTML 渲染為 PDF
  3. 使用 Chrome 的預設和響應式 CSS 模式來實現 PDF 的自動佈局。
  4. 利用縮放功能放大內容
  5. 針對特定使用場景配置"適應頁面"和"連續載入"


IronPDF中的紙張適配模式有哪些？

存取 RenderingOptions 中的PaperFit字段，以使用針對特定渲染類型和模式的預設方法。 這些模式提供了將 HTML 內容渲染到 PDF 頁面上的不同方法，類似於建立自訂紙張尺寸時所使用的技術。 讓我們透過渲染維基百科主頁進行比較，來檢驗每種 PaperFit 模式。

PaperFit 模式可處理各種內容佈局，從標準網頁到收據或報告等專業文件。 每種模式都針對特定使用場景進行了最佳化，確保 PDF 檔案無論來源內容的原始格式如何，都能保持預期的設計和可讀性。

如何使用Chrome預設渲染？

此模式會依照 Google Chrome 列印預覽中的顯示方式來佈局 PDF 頁面。 它配置渲染選項，使其與從 Chrome 列印網頁時的外觀相符。 響應式 CSS 視窗會根據紙張寬度來解釋指定的紙張尺寸。 使用 UseChromeDefaultRendering 方法進行配置。

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 模式下，透過向 UseResponsiveCssRendering 方法傳遞值來指定視窗寬度。 預設值為 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

如何使用縮放渲染？

UseScaledRendering 方法模擬 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 報告。

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

如何使用連續渲染？

連續進紙渲染會產生單頁 PDF 文件，將所有內容顯示在一頁上，適用於帳單或收據等文件。預設 PDF 頁面寬度為 80.0 毫米，頁邊距為 5 毫米。 Let's render the 'receipt.html' file to PDF.

使用 width 和 margin 參數自訂頁面寬度和邊距，以獲得更大的靈活性。 此模式可建立簡潔的單頁文件。 它可以產生收據、發票或任何需要連續顯示而無需分頁的文件。 結合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

準備好要看看你還能做什麼了嗎？ 請造訪我們的教學頁面：轉換 PDF 文件

常見問題解答

什麼是 HTML 至 PDF 轉換中的視口？

在 IronPDF 中，viewport 代表虛擬螢幕大小，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 Default Rendering 是 IronPDF 中的 PaperFit 模式，可按照在 Google Chrome 列印預覽中的顯示方式排版 PDF 頁面。它可設定渲染選項，以符合從 Chrome 瀏覽器列印網頁時的外觀，並根據指定的紙張大小詮釋相應的 CSS 視口。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
Nuget 下載 18,135,201 | 版本： 2026.4 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 變成 PDF。