C#で仮想ビューポートとズームを使用する方法

IronPDFの仮想ビューポートとズームの使い方

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

RenderingOptionsプロパティを使ってViewPortWidthZoomの値を設定したり、プリセットのPaperFitモードを活用してHTMLからPDFへの変換時に自動的にレイアウトを処理したりすることで、IronPDFのビューポートとズームをコントロールすることができます。

HTMLからPDFへのレンダリングでは、ビューポートによって、Webページのレイアウトが結果のPDFドキュメントにどのように取り込まれるかが決まります。 ブラウザがウェブページをレンダリングする際に使用する仮想の画面サイズを表します。 IronPDFのChromeレンダリングエンジンを使用する場合、正確な結果を得るためには、ビューポート設定を理解することが不可欠です。

ズームは、PDFドキュメント内のWebページコンテンツのスケーリングを制御します。 ズームレベルを微調整することで、PDF内のコンテンツサイズが調整され、適切なレイアウトとフォーマットが保証されます。 この機能は、異なるページサイズに適応しなければならないレスポンシブCSSレイアウトを扱うときに特に役立ちます。

クイックスタート: IronPDFでズームとビューポートを制御する

IronPDFを使用して、HTMLからPDFへの変換でズームとビューポートの設定を管理します。 このガイドでは、HTMLコンテンツのスケーリングを開始するための簡単なコードスニペットを提供します。 最小限のコードで、レスポンシブデザインの要素や希望するレイアウトを維持しながら、PDFが正しくレンダリングされるようにすることができます。

Nuget Icon今すぐ NuGet で PDF を作成してみましょう:

  1. NuGet パッケージ マネージャーを使用して 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の用紙フィットモードは何ですか?

RenderingOptionsPaperFitフィールドにアクセスして、特定のレンダリング タイプとモード用のプリセット メソッドを使用します。 これらのモードは、カスタム用紙サイズを作成するときに使用されるテクニックと同様に、HTMLコンテンツをPDFページにレンダリングするためのさまざまなアプローチを提供します。 比較のためにウィキペディアのメインページをレンダリングして、それぞれのPaperFitモードを調べてみましょう。

PaperFitのモードは、標準的なWebページから領収書や報告書のような特殊な文書まで、さまざまなコンテンツレイアウトに対応しています。 各モードは、特定の使用ケースに最適化され、ソースコンテンツの元の形式に関係なく、PDFが意図されたデザインと読みやすさを維持することを保証します。

どのように Chrome のデフォルト レンダリングを使用しますか?

このモードは、Google Chromeの印刷プレビューで表示されるようにPDFページをレイアウトします。 レンダリングオプションを設定し、Chromeから印刷したときのWebページの外観に合わせます。 レスポンシブ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");
$vbLabelText   $csharpLabel

レスポンシブ CSS レンダリングを使用するには?

レスポンシブ CSS モードでは、UseResponsiveCssRendering メソッドに値を渡してビューポート幅を指定します。 デフォルトのViewPortWidthは1280ピクセルです。 ビューポート単位はピクセルベースで、レスポンシブCSSデザインのための仮想ブラウザビューポートを表します。 このモードでは、最新のフレームワークを扱い、BootstrapおよびFlex CSSレイアウトで動作します。

レスポンシブCSSは、ViewPortWidthパラメータに基づいてHTMLレンダリングを定義し、指定された用紙サイズの幅に合わせてコンテンツを拡大縮小します。 このアプローチは、レスポンシブデザインの原則を使用する最新のウェブアプリケーションに適しており、元のビューポートサイズに関係なく、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");
$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");
$vbLabelText   $csharpLabel

ページ レンダリングに合わせるにはどうすればよいですか?

Fit to pageレンダリングは、指定された用紙サイズに合わせてコンテンツを拡大縮小します。レンダリング後のHTMLコンテンツの最小幅を測定し、可能な限り用紙1枚分の幅に収まるようにスケーリングします。 設定可能な最小ピクセル幅により、正しい表示とCSS3レイアウトルールへの応答性が保証されます。

このモードでは、水平方向に複数のページにまたがるコンテンツを扱います。 幅の広い表、グラフ、ダッシュボードなど、1ページの幅に収まる必要がある場合に効果的です。 自動スケーリングにより、水平スクロールなしですべてのコンテンツが表示されるため、読みやすさが重要な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");
$vbLabelText   $csharpLabel

連続フィード レンダリングを使用するにはどうすればよいですか?

連続フィードレンダリングは、すべてのコンテンツが1ページに収まる1ページPDFを作成し、消費者請求書や領収書などの文書に適しています。デフォルトのPDFページ幅は80.0ミリで、余白は5ミリです。 Let's render the 'receipt.html' file to PDF.

widthmarginパラメータを使用して、ページの幅とマージンを柔軟にカスタマイズします。 このモードでは、簡潔な1ページの文書を作成します。 領収書や請求書など、改ページのない連続した流れを必要とする文書を作成します。 HTML to 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");
$vbLabelText   $csharpLabel

次に何ができるのかを見てみましょうか? 私たちのチュートリアルページをご覧ください: PDFの変換

よくある質問

HTMLからPDFへの変換におけるビューポートとは何ですか?

IronPDFでは、ビューポートはChromeレンダリングエンジンがウェブページをPDFに変換する前にレンダリングする仮想的な画面サイズを表します。このビューポートは、ウェブページのレイアウトをどのようにPDFドキュメントに取り込むかを決定し、正確なレンダリング結果を得るために不可欠です。

1行のコードでズームとビューポート幅を制御するにはどうすればよいですか?

新しい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モードで、Google Chromeの印刷プレビューで表示されるようにPDFページをレイアウトします。レンダリングオプションを設定することで、Chromeから印刷したときのウェブページの外観に合わせ、指定された用紙サイズに基づいてレスポンシブCSSビューポートを解釈します。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 17,012,929 | バージョン: 2025.12 リリース