IronPDF 에서 C# 가상 뷰포트 및 확대/축소 기능을 사용하는 방법

Updated: 2026년 4월 22일

IronPDF에서 RenderingOptions 속성을 사용하여 뷰포트 및 확대를 제어하고 ViewPortWidth 및 Zoom 값을 설정하거나 HTML을 PDF로 변환하는 동안 자동 레이아웃 처리를 위한 사전 설정 PaperFit 모드를 활용하세요.

HTML을 PDF로 렌더링할 때 뷰포트는 웹 페이지 레이아웃이 결과 PDF 문서에 어떻게 표시되는지를 결정합니다. 이는 브라우저가 웹 페이지를 렌더링하는 데 사용하는 가상 화면 크기를 나타냅니다. IronPDF의 Chrome 렌더링 엔진을 사용할 때는 정확한 결과를 얻기 위해 뷰포트 설정을 이해하는 것이 필수적입니다.

줌 기능은 PDF 문서에서 웹 페이지 콘텐츠의 크기 조절을 제어합니다. 확대/축소 수준을 미세 조정하면 PDF의 콘텐츠 크기가 조정되어 레이아웃과 서식이 올바르게 유지됩니다. 이 기능은 다양한 페이지 크기에 맞춰 조정되어야 하는 반응형 CSS 레이아웃을 처리할 때 특히 유용합니다.

빠른 시작: IronPDF 로 확대/축소 및 뷰포트 제어하기

IronPDF 사용하여 HTML을 PDF로 변환할 때 확대/축소 및 뷰포트 설정을 관리하세요. 이 가이드는 HTML 콘텐츠 크기 조정을 시작하는 데 도움이 되는 간단한 코드 조각을 제공합니다. 최소한의 코드로 반응형 디자인 요소와 원하는 레이아웃을 유지하면서 PDF가 올바르게 렌더링되도록 할 수 있습니다.

UseChromeDefaultRendering UseResponsiveCssRendering ViewPortWidth UseScaledRendering width margin

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2다음 코드 조각을 복사하여 실행하세요.

new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
    .RenderUrlAsPdf("https://example.com")
    .SaveAs("zoomedViewport.pdf");

new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
    .RenderUrlAsPdf("https://example.com")
    .SaveAs("zoomedViewport.pdf");

3실제 운영 환경에서 테스트할 수 있도록 배포하세요.

무료 체험판으로 오늘 프로젝트에서 IronPDF 사용 시작하기

최소 워크플로우(5단계)

PDF 렌더링 및 뷰포트 제어를 위한 IronPDF C# 라이브러리를 다운로드하세요.
RenderHtmlToPdf를 사용하여 서로 다른 미리 설정된 모드 사용
PDF에서 자동 레이아웃을 달성하기 위해 ChromeDefault와 ResponsiveCSS 모드를 사용하세요.
배율 조정을 활용하여 콘텐츠를 확대/축소하세요.
특정 사용 사례를 위해 FitToPage와 ContinuousFeed를 사용하여 '페이지에 맞추기' 및 '연속 공급'을 구성하세요.

IronPDF 의 용지 맞춤 모드는 무엇인가요?

PaperFit 필드를 RenderingOptions에서 접속하여 특정 렌더링 유형 및 모드에 대한 사전 설정 메서드를 사용할 수 있습니다. 이러한 모드는 사용자 지정 용지 크기를 만들 때 사용되는 기술과 유사하게 HTML 콘텐츠를 PDF 페이지에 렌더링하는 다양한 접근 방식을 제공합니다. 비교를 위해 Wikipedia 메인 페이지를 렌더링하여 각 PaperFit 모드를 살펴보겠습니다.

PaperFit 모드는 표준 웹 페이지부터 영수증이나 보고서와 같은 특수 문서에 이르기까지 다양한 콘텐츠 레이아웃을 지원합니다. 각 모드는 특정 사용 사례에 최적화되어 원본 콘텐츠의 형식과 관계없이 PDF가 의도된 디자인과 가독성을 유지하도록 보장합니다.

Chrome 기본 렌더링을 어떻게 사용하나요?

이 모드는 PDF 페이지를 Google Chrome의 인쇄 미리보기에서 보이는 것처럼 배치합니다. 이 기능은 Chrome에서 인쇄할 때 웹 페이지의 모양과 일치하도록 렌더링 옵션을 구성합니다. 반응형 CSS 뷰포트는 너비를 기준으로 지정된 용지 크기를 해석합니다. ChromeDefaultRendering 메서드를 사용하여 이를 구성하세요.

Chrome의 기본 렌더링은 브라우저의 인쇄 기대치와 일관성을 유지합니다. 이 기능은 일반적인 웹 페이지 및 문서에서 브라우저 인쇄 시 나타나는 자연스러운 콘텐츠 흐름을 유지하려는 경우에 효과적입니다. JavaScript 렌더링이 필요한 고급 시나리오의 경우, 이 모드는 동적 콘텐츠의 적절한 실행 및 표시를 보장합니다.

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

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

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

반응형 CSS 렌더링은 어떻게 사용하나요?

반응형 CSS 모드에서, SetWidth 메서드에 값을 전달하여 뷰포트 너비를 지정하세요. 기본 **Width**은 1280 픽셀입니다. 뷰포트 단위는 픽셀 기반이며, 반응형 CSS 디자인을 위한 가상 브라우저 뷰포트를 나타냅니다. 이 모드는 최신 프레임워크를 지원하며 Bootstrap 및 Flex CSS 레이아웃 과 호환됩니다.

반응형 CSS는 ViewPortWidth 매개변수를 기반으로 HTML 렌더링을 정의하며, 지정된 용지 크기 너비에 맞추어 콘텐츠를 확장합니다. 이 접근 방식은 반응형 디자인 원칙을 사용하는 최신 웹 애플리케이션에 적합하며, 원래 뷰포트 크기에 관계없이 PDF가 의도한 레이아웃을 유지하도록 보장합니다. 사용자 지정 여백을 사용하는 경우, 이 모드는 다양한 페이지 크기에 맞춰 콘텐츠를 정밀하게 조정할 수 있도록 해줍니다.

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

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

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

이 종류의 라이브러리 중 가장 좋아하는 것은 IronPDF입니다. PDF 파일을 빠르고 효율적으로 조작할 수 있습니다. 또한 PDF/A 형식으로 내보내기 및 PDF 문서의 디지털 서명과 같은 많은 유용한 기능을 가지고 있습니다.

Milan Jovanovic

마이크로소프트 MVP

사례 연구 보기

IronOCR 덕분에 연간 $40,000를 수동 프로세싱에서 절약하고 생산성을 높이며 고부가가치 작업에 자원을 활용할 수 있습니다. 강력히 추천합니다.

브렌트 마첼

최고 기술 책임자, OPYN

사례 연구 보기

확대/축소 렌더링은 어떻게 사용하나요?

SetScaledRendering 메서드는 지정된 용지 크기에 대해 Chrome 인쇄 미리보기 동작을 모방하며 조정 가능한 줌 레벨을 제공합니다. 이 메서드는 입력된 확대/축소 비율에 따라 콘텐츠 크기를 조정합니다.

확대/축소 렌더링은 PDF에서 콘텐츠의 모양을 정밀하게 제어할 수 있도록 해줍니다. 고정된 뷰포트 방식과 달리, 이 방법은 콘텐츠 크기를 동적으로 조절할 수 있어 다양한 배율에서 가독성이 요구되는 문서나 여러 디스플레이 환경에 맞춰 PDF를 제작할 때 이상적입니다. 이 기술은 최적의 문서 표시를 위해 페이지 방향 및 회전 설정을 보완합니다.

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

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

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

페이지 맞춤 렌더링은 어떻게 사용하나요?

용지 크기에 맞추기 렌더링은 지정된 용지 크기에 맞게 콘텐츠 크기를 조정합니다. 렌더링 후 HTML 콘텐츠의 최소 너비를 측정하고 가능한 경우 한 장의 용지 너비에 맞게 크기를 조정합니다. 설정 가능한 최소 픽셀 너비는 CSS3 레이아웃 규칙에 따라 올바른 표시와 반응성을 보장합니다.

이 모드는 가로로 여러 페이지에 걸쳐 있는 콘텐츠를 처리합니다. 이 기능은 한 페이지 너비 안에 맞춰야 하는 넓은 표, 차트 또는 대시보드에 적합합니다. 자동 크기 조정 기능 덕분에 가로 스크롤 없이 모든 콘텐츠가 표시되므로 가독성이 중요한 PDF 보고서 생성 에 이상적입니다.

연속 피드 렌더링은 어떻게 사용하나요?

연속 피드 렌더링은 모든 내용을 한 페이지에 담는 단일 페이지 PDF를 생성하며, 소비자 청구서나 영수증과 같은 문서에 적합합니다. 기본 PDF 페이지 너비는 80.0mm이고 여백은 5mm입니다. ' receipt.html ' 파일을 PDF로 렌더링해 보겠습니다.

SetPageWidth 및 SetMargins 매개변수를 사용하여 페이지 너비 및 여백을 사용자 정의하여 유연성을 제공합니다. 이 모드는 간결한 단일 페이지 문서를 생성합니다. 이 프로그램은 페이지 나누기 없이 연속적인 흐름이 필요한 영수증, 송장 또는 기타 문서를 생성합니다. HTML을 PDF로 변환할 때 페이지 나누기 제어 기능 과 결합하면 특정 요구 사항에 맞는 정교한 문서 레이아웃을 만들 수 있습니다.

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

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

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

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? PDF 변환 방법에 대한 튜토리얼 페이지는 여기에서 확인하세요.

자주 묻는 질문

HTML을 PDF로 변환할 때 뷰포트란 무엇인가요?

IronPDF에서 뷰포트는 Chrome 렌더링 엔진이 웹 페이지를 PDF로 변환하기 전에 렌더링하는 데 사용하는 가상 화면 크기를 나타냅니다. 뷰포트는 웹 페이지 레이아웃이 결과 PDF 문서에 어떻게 반영되는지를 결정하며, 이는 정확한 렌더링 결과를 얻는 데 필수적입니다.

한 줄의 코드로 확대/축소와 뷰포트 너비를 제어하려면 어떻게 해야 할까요?

IronPDF에서는 한 줄의 코드로 뷰포트 너비와 확대/축소 배율을 모두 제어할 수 있습니다. 예를 들어, 다음과 같이 작성할 수 있습니다. `new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }.RenderUrlAsPdf('https://example.com').SaveAs('zoomedViewport.pdf')`. 이 코드는 뷰포트 너비를 1280px로 설정하고 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 페이지를 배치합니다. 지정된 용지 크기에 따라 반응형 CSS 뷰포트를 해석하여 Chrome에서 인쇄할 때 웹 페이지 모양과 일치하도록 렌더링 옵션을 구성합니다.

Can continuous feed rendering be customized in IronPDF?

Yes, continuous feed rendering can be customized by adjusting the PDF page width and margin. This mode is suitable for documents like receipts or invoices, requiring a single continuous page without breaks.

How do I implement minimal workflow steps with IronPDF?

Begin by downloading the IronPDF C# library. Use `RenderHtmlAsPdf` with preconfigured modes, leverage scaling for zoom, and configure 'fit to page' or 'continuous feed' using specific methods like `FitToPage` or `ContinuousFeed`.

What is the benefit of using the `UseContinuousFeedRendering` method?

The `UseContinuousFeedRendering` method creates a single-page PDF accommodating all content, ideal for documents requiring a seamless flow, such as receipts or invoices.

What is the advantage of using `UseResponsiveCssRendering` in IronPDF?

Using `UseResponsiveCssRendering` in IronPDF allows for handling modern web frameworks effectively, ensuring responsive design principles are upheld and that PDFs adapt to differing viewport sizes efficiently.

Curtis Chau

지금 바로 엔지니어링 팀과 채팅하세요

기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

...

더 읽어보기