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

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

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

IronPDF에서 뷰포트와 확대/축소를 제어하려면 RenderingOptions 속성을 사용하여 ViewPortWidthZoom 값을 설정하거나, HTML을 PDF로 변환하는 동안 레이아웃을 자동으로 처리하는 사전 설정된 PaperFit 모드를 활용하세요.

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

줌 기능은 PDF 문서에서 웹 페이지 콘텐츠의 크기 조절을 제어합니다. 확대/축소 수준을 미세 조정하면 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 모드는 표준 웹 페이지부터 영수증이나 보고서와 같은 특수 문서에 이르기까지 다양한 콘텐츠 레이아웃을 지원합니다. 각 모드는 특정 사용 사례에 최적화되어 원본 콘텐츠의 형식과 관계없이 PDF가 의도된 디자인과 가독성을 유지하도록 보장합니다.

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

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

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

: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

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

용지 크기에 맞추기 렌더링은 지정된 용지 크기에 맞게 콘텐츠 크기를 조정합니다. 렌더링 후 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");
$vbLabelText   $csharpLabel

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

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

페이지 너비와 여백을 유연하게 조정하려면 widthmargin 매개변수를 사용하십시오. 이 모드는 간결한 단일 페이지 문서를 생성합니다. 이 프로그램은 페이지 나누기 없이 연속적인 흐름이 필요한 영수증, 송장 또는 기타 문서를 생성합니다. 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");
$vbLabelText   $csharpLabel

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

자주 묻는 질문

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

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 기본 렌더링은 IronPDF의 PaperFit 모드로, Google Chrome의 인쇄 미리보기에서 보이는 것처럼 PDF 페이지를 배치합니다. 지정된 용지 크기에 따라 반응형 CSS 뷰포트를 해석하여 Chrome에서 인쇄할 때 웹 페이지 모양과 일치하도록 렌더링 옵션을 구성합니다.

커티스 차우
기술 문서 작성자

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

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 17,527,568 | 버전: 2026.2 방금 출시되었습니다