1. IronPrint
  2. 방법
  3. PDF 병합

이 페이지에서

C#에서 인쇄 전에 PDF를 평면화하는 방법

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/article_date_line.php

Line Number: 60

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/article_date_line.php
Line: 60
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 52
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPrint의 PrintSettings 클래스에는 모든 대화형 폼 필드, 주석 및 이미지 레이어를 인쇄 시 정적 콘텐츠로 병합하는 Flatten 속성이 포함되어 있습니다. 우리는 우리의 PrintSettings 객체에 Flatten = true를 설정하고, IronPrint가 나머지를 처리합니다 — 별도의 PDF 조작 라이브러리나 중간 파일 저장이 필요하지 않습니다.

이 가이드는 언제, 어떻게 PDF를 인쇄 전에 평면화하는지 다루며, 동기, 결합 설정, 비동기 워크플로를 위한 작동 C# 코드를 포함합니다.

빠른 시작: 인쇄 전에 PDF 평면화

  1. NuGet을 통해 IronPrint 설치: Install-Package IronPrint
  2. 파일에 using IronPrint; 추가
  3. PrintSettings 객체 생성
  4. Flatten를 true로 설정
  5. 설정을 Printer.Print() 또는 Printer.PrintAsync()로 전달

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronPrint 설치하기

    PM > Install-Package IronPrint

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

    using IronPrint;

// Flatten and print a PDF with form fields
Printer.Print("form-document.pdf", new PrintSettings
{
    Flatten = true
});

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

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

    arrow pointer
### 최소 워크플로우(5단계)
  1. IronPrint C# 인쇄 라이브러리 설치
  2. `PrintSettings` 객체 생성
  3. `Flatten`을 `true`로 설정
  4. 설정을 `Printer.Print()`에 전달
  5. 인쇄된 출력에 평면화된 형식 필드가 포함되어 있는지 확인

C#에서 인쇄 전에 PDF를 어떻게 평면화합니까?

우리는 Flatten 속성을 true로 설정하여 인쇄 시간에 PDF를 평면화합니다. 그런 다음 해당 객체를 IronPrint의 인쇄 메서드 중 하나에 전달합니다.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/flatten-basic.cs
// 이 코드 조각은 사용할 수 없습니다!
$vbLabelText   $csharpLabel

우리는 먼저 PrintSettings를 인스턴스화하고, 이는 기본값 — Flatten = false을 포함하여 — 으로 초기화됩니다. 그런 다음 Flatten를 true로 설정하여 IronPrint에 프린트 작업을 보내기 전에 모든 대화형 요소를 페이지 콘텐츠로 병합하도록 지시합니다. Printer.Print를 호출하면, 프린터는 문서의 완전히 정적인 버전을 받습니다.

평면화는 인쇄 파이프라인 동안 메모리에서 발생합니다. 원본 PDF 파일은 디스크에서 대화형으로 남아 있으므로 최종 사용자가 여전히 양식을 작성하고 다시 제출할 수 있습니다. 이것은 중요한 구별점입니다: 우리는 프린터를 위해 평면화하고 있으며, 원본 파일을 영구히 변경하지 않습니다.

Flatten 속성은 IronPrint v2024.7.2에 도입되었고, 이후 모든 버전에서 사용 가능합니다.

언제 PDF를 인쇄 전에 평면화해야 하나요?

PDF에 올바르게 렌더링되지 않을 수 있는 대화형 요소가 포함되어 있을 때 평면화가 가장 가치가 있습니다. 가장 일반적인 사례는 다음과 같습니다:

양식 필드를 채울 수 있는 PDFs. 텍스트 입력, 체크박스, 라디오 버튼, 드롭다운 메뉴는 PDF 뷰어에서 렌더링되며 페이지 콘텐츠에 임베드되지 않습니다. 일부 프린터 드라이버는 이러한 레이어를 완전히 건너뛰어 인쇄된 페이지에 빈 필드를 남깁니다. 평면화는 필드 값을 정적 페이지 레이어로 강제합니다.

주석 또는 오버레이가 있는 PDFs. 주석, 스티커 노트, 스탬프, 마크업 주석은 별도의 레이어에 존재합니다. 평면화는 그들을 보이는 콘텐츠로 병합하여 인쇄된 출력에 나타나도록 합니다.

다양한 레이어에 내장된 이미지가 있는 PDFs. 여러 소스로 구성된 문서는 서로 다른 z-레이어에 이미지를 가질 수 있습니다. 평면화는 누락되거나 잘못 정렬된 이미지를 방지하기 위해 모든 것을 하나의 레이어로 통합합니다.

PDF에 단지 정적 텍스트와 이미지가 포함되어 있을 때 — 예를 들어 HTML에서 생성된 보고서나 스캔 문서 — 평면화는 영향을 미치지 않습니다. 이러한 경우, 불필요한 처리 오버헤드를 피하기 위해 Flatten를 기본값 false상태로 둘 수 있습니다.

평면화를 다른 인쇄 설정과 결합하는 방법은?

PrintSettings 클래스는 여러 속성과 Flatten을 함께 노출합니다. 우리는 평면화와 함께 용지 크기, 방향, DPI, 여백 및 복사 수를 하나의 인쇄 작업에 설정할 수 있습니다.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/combined-settings.cs
// 이 코드 조각은 사용할 수 없습니다!
$vbLabelText   $csharpLabel

명확성을 위해 객체 초기화 구문을 사용합니다. Flatten = true는 모든 폼 데이터가 인쇄된 페이지에 나타나게 합니다. PaperSize.A4와 PaperOrientation.Portrait는 비즈니스 폼의 표준 형식과 일치합니다. 300에서의 Dpi는 원래 화면 해상도로 렌더링된 채워진 필드에서 선명한 텍스트를 생성합니다. PaperMargins 은 Margins 생성자를 통해 밀리미터 단위로 네 가지 값을 받습니다.

이 속성들은 서로 충돌하지 않습니다. IronPrint는 평면화 작업을 먼저 적용하고, 결과적으로 생성된 정적 문서를 나머지 설정에 따라 포맷한 후 프린터에 작업을 보냅니다. 프린트 설정 옵션에는 프린터 선택 및 트레이 구성이 포함되어 있으며, 전체 구성 가이드를 참조하세요.

평면화 및 비동기 인쇄 방법은?

메인 스레드를 차단하는 것이 허용되지 않는 애플리케이션에서는 — 예를 들어 WPF 또는 WinForms 앱 — Printer.PrintAsync를 사용합니다. 이 메서드는 동일한 PrintSettings 객체를 수락하고 Task를 반환합니다.

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/async-flatten.cs
// 이 코드 조각은 사용할 수 없습니다!
$vbLabelText   $csharpLabel

이 클래스 기반 패턴은 서비스 계층에서 프린트 로직이 존재할 때 유용합니다. 우리는 Flatten = true를 함께 구성하고 PaperSize.Letter을 미국 형식의 서식을 위해 설정합니다. await 키워드는 IronPrint가 평면화 작업을 처리하고 인쇄 작업을 보낼 때 호출 스레드를 해제합니다.

IronPrint의 비동기 메서드 — PrintAsync와 ShowPrintDialogAsync를 포함한 — 모두 동기 메서드와 동일하게 Flatten 설정을 존중합니다. 조용히 인쇄하거나 인쇄 대화상자를 통해 인쇄하든, 평면화 동작은 일관성을 유지합니다.

내 다음 단계는 무엇인가요?

우리는 IronPrint의 PrintSettings.Flatten 속성을 사용하여 C#에서 인쇄 전에 PDF를 평면화하는 방법을 다루었습니다. 주요 요점: Flatten = true를 설정하여 대화형 폼 필드, 주석, 이미지 레이어를 인쇄 시 정적 콘텐츠로 병합합니다 — 원본 파일을 수정하지 않고.

이 작업을 계속 진행하려면:

무료 30일 체험판을 시작하여 자신의 프린트 워크플로에서 PDF 평면화를 테스트하거나, 생산 사용을 위한 라이선스 옵션 보기.

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'name'

Filename: sections/author_component.php

Line Number: 18

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 18
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

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

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'title'

Filename: sections/author_component.php

Line Number: 38

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 38
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Warning

Message: Illegal string offset 'comment'

Filename: sections/author_component.php

Line Number: 48

Backtrace:

File: /var/www/ironpdf.com/application/views/main/sections/author_component.php
Line: 48
Function: _error_handler

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 63
Function: view

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 64
Function: main_view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

시작할 준비 되셨나요?
Nuget 다운로드 38,093 | 버전: 2026.3 방금 출시되었습니다
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronPrint
샘플을 실행하세요 문서가 프린터로 전송되는 것을 지켜보세요.