C#에서 인쇄를 위한 용지 크기 설정 방법

C#에서 인쇄할 때 용지 크기 설정 방법은?

PrintSettings 객체의 PaperSize 속성에 PaperSize 열거형의 값을 할당하여 용지 크기를 설정합니다. 그런 다음 해당 객체를 IronPrint의 인쇄 메서드 중 하나에 전달합니다.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-set-paper-size.cs

using IronPrint;

// Configure print settings with US Letter paper
PrintSettings settings = new PrintSettings();
settings.PaperSize = PaperSize.Letter;

// Print to the default printer
Printer.Print("invoice.pdf", settings);

Imports IronPrint

' Configure print settings with US Letter paper
Dim settings As New PrintSettings()
settings.PaperSize = PaperSize.Letter

' Print to the default printer
Printer.Print("invoice.pdf", settings)

먼저 PrintSettings를 인스턴스화하면, 프린터의 기본값으로 초기화됩니다. 그런 다음 PaperSize을 표준 8.5 × 11인치 형식으로 매핑되는 PaperSize.Letter로 재정의합니다. Printer.Print를 호출하면 IronPrint는 해당 용지 크기를 사용하여 문서를 시스템의 기본 프린터로 전송합니다.

PaperSize가 지정되지 않은 경우, IronPrint는 PaperSize.PrinterDefault를 사용하며, 이는 운영 체제의 기본 프린터가 사용하도록 구성된 용지 크기를 따릅니다. 이는 관련 장비에 따라 프린터 구성이 다른 생산 환경에서 중요한 세부 사항입니다.

라이브러리가 지원하는 용지 크기는 무엇인가요?

PaperSize 열거형에는 ISO 국제 표준, 일반적인 미국 규격 및 프린터 기본 설정을 포함하는 12개의 값이 있습니다. 아래 표는 사용 가능한 모든 옵션을 나열합니다.

각 값은 잘 알려진 종이 표준에 직접 매핑됩니다. PrinterDefault 옵션은 IronPrint가 프린터가 현재 설정된 크기를 사용하도록 지시합니다. 이는 특정 형식을 강제하기보다 최종 사용자의 프린터 설정을 존중하고자 할 때 유용합니다.

전체 API 참조는 PaperSize 클래스 문서를 참조하십시오.

다른 인쇄 설정과 용지 크기를 결합하는 방법은?

PrintSettings 클래스는 PaperSize 외에도 여러 속성을 제공합니다. 방향, DPI, 여백, 복사본 수, 회색조 모드를 하나의 객체 내에서 구성할 수 있습니다.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-combined-settings.cs

using IronPrint;

// Configure full print settings
PrintSettings settings = new PrintSettings
{
    PaperSize = PaperSize.A4,
    PaperOrientation = PaperOrientation.Landscape,
    Dpi = 300,
    NumberOfCopies = 3,
    PaperMargins = new Margins(15, 15, 15, 15),
    Grayscale = false
};

// Print the quarterly report
Printer.Print("quarterly-report.pdf", settings);

Imports IronPrint

' Configure full print settings
Dim settings As New PrintSettings With {
    .PaperSize = PaperSize.A4,
    .PaperOrientation = PaperOrientation.Landscape,
    .Dpi = 300,
    .NumberOfCopies = 3,
    .PaperMargins = New Margins(15, 15, 15, 15),
    .Grayscale = False
}

' Print the quarterly report
Printer.Print("quarterly-report.pdf", settings)

이곳에서는 명확성을 위해 객체 초기자 구문을 사용합니다. Orientation는 A4 용지를 가로 방향으로 회전합니다. DPI 300 설정은 차트와 작은 텍스트를 선명하게 출력합니다. Margins은 Margins 생성자를 통해 상단, 우측, 하단, 좌측의 네 가지 값(단위: 밀리미터)을 받아들입니다. CopyCount 속성의 기본값은 1이지만, 가독성을 위해 명시적으로 설정했습니다.

이 속성들은 충돌 없이 함께 작동합니다. IronPrint는 구성을 검증하고 결합된 설정을 단일 인쇄 작업으로 프린터 드라이버에 전달합니다. 프린터 선택 및 트레이 구성과 같은 고급 설정에 대해서는 전체 인쇄 설정 가이드를 참조하십시오.

사용자 정의 용지 크기로 비동기 인쇄하는 방법은?

WPF나 WinForms 애플리케이션처럼 메인 스레드를 차단할 수 없는 환경에서는 Printer.PrintAsync을 사용합니다. 이 메서드는 동일한 PrintSettings 객체를 받아 Task를 반환합니다.

:path=/static-assets/print/content-code-examples/how-to/set-paper-size/set-paper-size-async-print.cs

using IronPrint;
using System.Threading.Tasks;

public class DocumentPrinter
{
    public async Task PrintLegalDocumentAsync(string filePath)
    {
        // Configure Legal paper size
        PrintSettings settings = new PrintSettings
        {
            PaperSize = PaperSize.Legal,
            PaperOrientation = PaperOrientation.Portrait,
            Dpi = 300
        };

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

Imports IronPrint
Imports System.Threading.Tasks

Public Class DocumentPrinter
    Public Async Function PrintLegalDocumentAsync(filePath As String) As Task
        ' Configure Legal paper size
        Dim settings As New PrintSettings With {
            .PaperSize = PaperSize.Legal,
            .PaperOrientation = PaperOrientation.Portrait,
            .Dpi = 300
        }

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

이 클래스 기반 예제는 DocumentPrinter 서비스가 PRINT 로직을 감싸는 실제적인 패턴을 보여줍니다. 계약서 및 법적 서류 제출의 표준 형식인 PaperSize.Legal(8.5 × 14인치)로 구성합니다. await 키워드는 IronPrint가 인쇄 작업을 처리하는 동안 호출 스레드가 응답성을 유지하도록 보장합니다.

이 메서드는 버튼 클릭 핸들러, 백그라운드 서비스 또는 await가 지원되는 모든 곳에서 호출할 수 있습니다. IronPrint의 비동기 메서드(PrintAsync 및 ShowPrintDialogAsync 포함)는 동일한 PrintSettings 구성을 지원하므로, 종이 크기 관련 동작은 동기식 및 비동기식 경로에서 동일합니다.

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

IronPrint의 PaperSize 열거형을 사용하여 C#에서 용지 크기를 설정하는 방법을 다루었습니다. 기본적인 단일 속성 구성부터 복합 설정 및 비동기 인쇄에 이르기까지 다뤘습니다. PrintSettings 클래스는 종이 크기에 대한 추측을 없애주는 깔끔하고 강력한 타입의 API를 제공합니다.

IronPrint의 기능을 계속 탐구하려면:

• 프린터 이름, 트레이 및 회색조를 포함한 모든 인쇄 설정을 구성하는 방법을 배우세요
• 일반적인 시나리오에 대한 작동 중인 인쇄 설정 코드 예제를 보세요
• Printer, PrintSettings, PaperSize와 같은 클래스에 대한 전체 API 레퍼런스를 살펴보세요.

무료 30일 체험판을 시작하여 프로젝트에서 용지 크기 구성을 테스트하거나, 배포 라이선스 옵션 보기를 확인하세요.

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false