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

입력

ShowPrintDialog로 전달된 quarterly-report.pdf는 KPI 지표 카드와 사업부별 매출 표가 포함된 기업용 3분기 재무 요약 문서로, PRINT 대화 상자로 전송되는 일반적인 비즈니스 문서를 나타냅니다.

: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 print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf");

Imports IronPrint

' Open the print dialog and print
Printer.ShowPrintDialog("quarterly-report.pdf")

산출

ShowPrintDialog으로 열리는 분기별 보고서의 네이티브 인쇄 대화 상자.

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

입력

A4 세로 방향 설정으로 미리 로드된 invoice.pdf: 전문 청구서에는 라인 항목, 할인, 세금 및 송금 지침이 포함되어 있으며, 애플리케이션이 이미 필요한 용지 크기와 방향을 알고 있는 현실적인 문서를 보여줍니다.

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

using IronPrint;

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

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

Imports IronPrint

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

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

산출

사전 구성된 A4 세로 방향 설정으로 열리는 네이티브 인쇄 대화 상자.

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

시스템에서 사용 가능한 프린터를 확인하려면 Printer.GetPrinterNames()을 호출하면 되며, 이 함수는 설치된 모든 프린터의 List<string>을 반환합니다. 마찬가지로, Printer.GetPrinterTrays()는 지정된 프린터에서 사용 가능한 용지함을 반환합니다.

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

입력

비동기로 대기 중인 report.pdf: IT 인프라 및 보안 보고서로 구성된 장문 형식의 문서를 나타내며, 파일이 로드되는 동안 비차단 대화 상자 프레젠테이션을 유지하여 UI 응답성을 유지할 수 있습니다.

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

using IronPrint;

// Open the print dialog asynchronously
await Printer.ShowPrintDialogAsync("report.pdf");

Imports IronPrint

' Open the print dialog asynchronously
Await Printer.ShowPrintDialogAsync("report.pdf")

산출

ShowPrintDialogAsync를 통해 비동기적으로 열리는 네이티브 인쇄 대화 상자, 콘솔이 비차단 실행을 확인합니다.

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

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

입력

monthly-report.pdf 파일이 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)

산출

위의 예에서 볼 수 있듯이 대화 상자가 열립니다. 형식 감지는 자동으로 이루어집니다. 파일 경로를 전달하든 byte[]를 전달하든, IronPrint는 문서를 렌더링하고 동일한 기본 대화 상자를 표시합니다.

코드 예제 페이지에서 추가적인 형식별 시나리오를 보여줍니다. PDF 전용 워크플로(참고: PDF 생성 및 즉시 인쇄)를 위해 IronPDF가 IronPrint와 자연스럽게 짝을 이룹니다.