대화 상자를 통해 C#에서 문서 인쇄하는 방법

인쇄 대화 상자가 C#에서 어떻게 작동합니까?

Printer.ShowPrintDialog() 메서드는 운영 체제의 기본 인쇄 대화 상자를 엽니다. 사용자는 프린터 선택, 복사본 수, 페이지 범위, 방향 및 용지 크기를 포함한 전체 인쇄 옵션을 확인하고 인쇄 버튼을 클릭하여 작업을 보내거나, 인쇄 없이 대화 상자를 닫으려면 취소를 클릭합니다.

내부적으로, 네이티브 .NET 접근 방식은 System.Windows.Forms.PrintDialog 인스턴스를 생성하고 이를 PrintDocument에 연결하며, 콘텐츠를 인쇄 그래픽 표면에 그리기 위한 PrintPage 이벤트를 처리하고, DialogResult를 확인한 후 PrintDocument.Print()을 호출해야 합니다. 그 설정은 일반적으로 15–25줄의 코드로 실행됩니다. 또한 기본 제공 PDF 또는 이미지 렌더링을 포함하지 않습니다. 기본 대화 상자를 통해 PDF를 인쇄하려면 먼저 PDF를 그릴 수 있는 페이지로 구문 분석해야 하며, 이를 위해 또 다른 라이브러리가 필요합니다.

IronPrint는 전체 파이프라인을 한 번의 호출로 처리합니다.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-open-and-print.cs

using IronPrint;

// Open the dialog, let the user configure settings, and print
Printer.ShowPrintDialog("quarterly-report.pdf");

Imports IronPrint

' Open the dialog, let the user configure settings, and print
Printer.ShowPrintDialog("quarterly-report.pdf")

메서드는 string로 파일 경로를 받거나 byte[]로 원시 파일 데이터를 받을 수 있습니다. IronPrint는 문서 형식을 감지하고 적절한 엔진을 통해 렌더링한 다음 대화 상자를 표시합니다. 사용자가 확인하면 선택한 설정으로 문서가 인쇄됩니다. 문서 인쇄 튜토리얼에서는 전체 인쇄 수명 주기에 대해 자세히 설명합니다.

대화 상자 설정을 사전 구성하려면 어떻게 해야 하나요?

PrintSettings 개체를 생성하고 두 번째 매개변수로 전달하여 대화 상자가 열리기 전에 기본값을 설정할 수 있습니다. 대화 상자는 이 값이 미리 선택된 상태로 열리며 사용자는 그대로 수락하거나 설정을 변경할 수 있습니다.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-preconfigure-dialog-settings.cs

using IronPrint;

// Pre-configure defaults for the dialog
var settings = new PrintSettings
{
    PrinterName = "HP LaserJet Pro",
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Portrait,
    Dpi = 300,
    NumberOfCopies = 2,
    Grayscale = false
};

// Open dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings);

Imports IronPrint

' Pre-configure defaults for the dialog
Dim settings As New PrintSettings With {
    .PrinterName = "HP LaserJet Pro",
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Portrait,
    .Dpi = 300,
    .NumberOfCopies = 2,
    .Grayscale = False
}

' Open dialog with pre-filled settings
Printer.ShowPrintDialog("invoice.pdf", settings)

이는 응용 프로그램이 예상되는 프린터나 용지 형식을 미리 알고 있을 때 유용합니다. 예를 들어, 항상 특정 열 프린터에서 영수증을 출력하는 판매 시점 시스템은 기본 PrinterName을 해당 장치로 설정할 수 있습니다. 사용자는 여전히 대화 상자에서 변경할 수 있는 옵션이 있습니다.

시스템에 사용 가능한 프린터를 확인하기 위해 우리는 Printer.GetPrinterNames()를 호출합니다. 이는 모든 설치된 프린터의 List<string>를 반환합니다. 마찬가지로, Printer.GetPrinterTrays()은 주어진 프린터에 대해 사용 가능한 용지 트레이들을 반환합니다.

구성 가능한 속성의 전체 목록은 PrinterName, PaperSize, PaperOrientation, Dpi, NumberOfCopies, Grayscale, PaperMargins, Flatten (PDF 폼 필드용), 및 Tray을 포함합니다. 인쇄 설정 안내서는 각 속성을 코드 예제와 함께 다룹니다. PrintSettings 에 설정되지 않은 모든 속성은 선택된 프린터의 표준 구성을 기본값으로 사용합니다.

비동기적으로 대화 상자를 표시하려면 어떻게 해야 하나요?

Printer.ShowPrintDialogAsync() 메서드는 Task을 반환하여 await와 호환됩니다. 이 메서드는 WPF, MAUI 및 인터페이스가 멈추면 사용자 경험이 저하되는 모든 응용 프로그램에서 UI 스레드를 차단하지 않게 합니다.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-show-print-dialog-async.cs

using IronPrint;

// Non-blocking dialog — the UI remains responsive
await Printer.ShowPrintDialogAsync("report.pdf");

Imports IronPrint

' Non-blocking dialog — the UI remains responsive
Await Printer.ShowPrintDialogAsync("report.pdf")

ShowPrintDialogAsync() 는 동기 버전과 동일한 매개변수를 받습니다: 파일 경로나 바이트 배열, 그리고 옵션 PrintSettings 객체. 비동기 패턴은 최신 .NET 개발 전반에 걸쳐 사용되는 작업 기반 비동기 패턴을 따릅니다.

IronPrint는 WinForms, WPF, MAUI, 콘솔 응용 프로그램 전반에서 작동합니다. 대화 상자 모양은 호스트 플랫폼 및 운영 체제 버전에 맞게 조정되므로 사용자는 항상 예상하는 기본 인쇄 창을 보게 됩니다.

언제 대화 상자를 사용하고 언제 무음 인쇄를 사용해야 하나요?

그 선택은 사용자가 인쇄 작업을 제어해야 하는지 여부에 따라 다릅니다.

사용자가 인쇄 전에 설정을 확인하거나 변경해야 하는 경우 대화 상자를 사용하십시오 — 보고서 내보내기, 송장 인쇄 또는 잘못된 프린터로 인해 페이지가 낭비되는 모든 상황에서 대화 상자를 사용하세요. 무음 인쇄는 응용 프로그램이 전체 작업을 제어하고 사람의 결정이 필요하지 않을 때 사용하세요. 문서 인쇄 튜토리얼은 두 가지 접근 방식을 나란히 설명합니다.

인쇄 대화 상자가 지원하는 파일 형식은 무엇입니까?

Printer.ShowPrintDialog() 는 조용한 인쇄와 동일한 형식을 지원합니다: PDF, PNG, TIFF, JPEG, GIF, HTML, 및 BMP. 우리는 형식에 상관없이 파일 경로를 전달하며, IronPrint는 렌더링과 인쇄 스풀러 통신을 처리합니다. 파일 데이터는 byte[] 로도 수용되며, 이는 문서가 메모리에서 생성되거나 데이터베이스에서 검색될 때 유용합니다.

:path=/static-assets/print/content-code-examples/how-to/print-with-dialog/print-with-dialog-print-dialog-image-and-byte-array.cs

using IronPrint;

// Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png");

// Print from a byte array
byte[] reportData = File.ReadAllBytes("monthly-report.pdf");
Printer.ShowPrintDialog(reportData);

Imports IronPrint

' Print an image with the dialog
Printer.ShowPrintDialog("product-photo.png")

' Print from a byte array
Dim reportData As Byte() = File.ReadAllBytes("monthly-report.pdf")
Printer.ShowPrintDialog(reportData)

코드 예제 페이지에서 추가적인 형식별 시나리오를 보여줍니다. PDF 특정 작업 흐름 — PDF를 생성하고 즉시 인쇄 — IronPDF와 IronPrint가 자연스럽게 결합됩니다. IronPrint 대 IronPDF 비교는 언제 각자를 사용해야 하는지 설명합니다.

다음 단계

대화 상자를 통한 인쇄는 두 가지 메서드로 이루어집니다: 동기 호출용 Printer.ShowPrintDialog() 와 비차단 실행용 Printer.ShowPrintDialogAsync(). PrintSettings 를 사용하여 기본값을 미리 구성하고 거기서부터 사용자가 조정하도록 합니다. 두 가지 방법 모두 IronPrint의 문서 형식을 지원하며 WinForms, WPF, MAUI 및 콘솔 프로젝트 전반에서 작동합니다.

IronPrint 튜토리얼에서 전체 사용 방법을 안내하는 가이드, 사용 가능한 모든 방법에 대한 프린터 클래스 API 참조 또는 고급 구성에 대한 인쇄 설정 가이드를 탐색하세요. 변경 로그에서는 최근 개선 사항과 새로운 기능을 추적합니다.

실제 프로젝트에서 대화형 인쇄를 테스트하기 위해 무료 30일 체험판 시작하기 - 신용 카드 불필요. 출시 준비가 되면 라이선스 옵션 보기 $749부터 시작합니다.