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

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

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

:path=/static-assets/print/content-code-examples/how-to/flatten-pdfs/flatten-pdfs-flatten-basic.cs

using IronPrint;

// Configure print settings with flattening enabled
PrintSettings settings = new PrintSettings();
settings.Flatten = true;

// Send the flattened document to the default printer
Printer.Print("application-form.pdf", settings);

Imports IronPrint

' Configure print settings with flattening enabled
Dim settings As New PrintSettings()
settings.Flatten = True

' Send the flattened document to the default printer
Printer.Print("application-form.pdf", settings)

우리는 먼저 기본값(예: Flatten = false 포함)으로 초기화되는 PrintSettings를 인스턴스화합니다. 그 다음 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/flatten-pdfs-combined-settings.cs

using IronPrint;

// Flatten and print with full configuration
PrintSettings settings = new PrintSettings
{
    Flatten = true,
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    PaperMargins = new Margins(10, 10, 10, 10),
    Grayscale = false
};

// Print a filled-out insurance claim form
Printer.Print("insurance-claim.pdf", settings);

Imports IronPrint

' Flatten and print with full configuration
Dim settings As New PrintSettings With {
    .Flatten = True,
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .PaperMargins = New Margins(10, 10, 10, 10),
    .Grayscale = False
}

' Print a filled-out insurance claim form
Printer.Print("insurance-claim.pdf", settings)

명확성을 위해 객체 초기화 구문을 사용합니다. 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/flatten-pdfs-async-flatten.cs

using IronPrint;
using System.Threading.Tasks;

public class FormPrinter
{
    public async Task PrintFlattenedFormAsync(string pdfPath)
    {
        // Flatten form fields and print asynchronously
        PrintSettings settings = new PrintSettings
        {
            Flatten = true,
            PaperSize = PaperSize.Letter,
            Dpi = 300
        };

        // Non-blocking print — UI thread stays responsive
        await Printer.PrintAsync(pdfPath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class FormPrinter
    Public Async Function PrintFlattenedFormAsync(pdfPath As String) As Task
        ' Flatten form fields and print asynchronously
        Dim settings As New PrintSettings With {
            .Flatten = True,
            .PaperSize = PaperSize.Letter,
            .Dpi = 300
        }

        ' Non-blocking print — UI thread stays responsive
        Await Printer.PrintAsync(pdfPath, settings)
    End Function
End Class

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

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

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

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

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

• 사용 가능한 모든 속성을 포함한 전체 프린트 설정 구성 가이드를 탐색
• 일반 패턴을 보기 위한 프린트 설정 코드 예제 보기
• 속성 세부 정보 및 기본값을 위한 PrintSettings API 참조 검토
• 최신 기능 및 개선 사항을 위한 IronPrint 변경로그 확인

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