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;

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

Imports IronPrint

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

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

먼저 PrintSettings를 인스턴스화하면, Flatten = false를 포함한 기본값으로 초기화됩니다. 그런 다음 Flatten을 true, Printer.Print, Flatten로 설정하면, IronPrint가 인쇄 작업을 전송하기 전에 모든 상호작용 요소를 페이지 콘텐츠에 병합하도록 지시합니다. [Print()]을 호출하면 프린터는 문서의 완전히 정적 버전을 수신합니다.

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

Flatten 속성은 IronPrint v2024.7.2에서 도입되었으며, 이후 모든 버전에서 사용할 수 있습니다.

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

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

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

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

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

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

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

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

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

using IronPrint;

// Configure flatten with full print settings
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 the insurance claim form
Printer.Print("insurance-claim.pdf", settings);

Imports IronPrint

' Configure flatten with full print settings
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 the insurance claim form
Printer.Print("insurance-claim.pdf", settings)

명확성을 위해 객체 초기화 구문을 사용합니다. EnsureFlatten은 모든 양식 데이터가 인쇄된 페이지에 표시되도록 보장합니다. PaperSize 및 Orientation는 비즈니스 양식의 표준 형식을 따릅니다. DPI을 300으로 설정하면, 원래 화면 해상도로 렌더링되었던 채워진 영역의 텍스트가 선명하게 표시됩니다. Margins은 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)
    {
        // Configure flatten with Letter paper at 300 DPI
        PrintSettings settings = new PrintSettings
        {
            Flatten = true,
            PaperSize = PaperSize.Letter,
            Dpi = 300
        };

        // Print asynchronously
        await Printer.PrintAsync(pdfPath, settings);
    }
}

Imports IronPrint
Imports System.Threading.Tasks

Public Class FormPrinter
    Public Async Function PrintFlattenedFormAsync(pdfPath As String) As Task
        ' Configure flatten with Letter paper at 300 DPI
        Dim settings As New PrintSettings With {
            .Flatten = True,
            .PaperSize = PaperSize.Letter,
            .Dpi = 300
        }

        ' Print asynchronously
        Await Printer.PrintAsync(pdfPath, settings)
    End Function
End Class

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

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

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

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

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

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

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