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

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPrint의 PrintSettings 클래스는 PaperSize 속성을 통해 용지 크기에 대한 개발자에게 직접 제어를 제공합니다. 우리는 PaperSize 열거형에서 값을 할당합니다 — 예를 들어 PaperSize.A4 또는 PaperSize.Letter — 그리고 구성된 PrintSettings 객체를 IronPrint의 모든 인쇄 메서드에 전달합니다. 프린터는 이후 해당 작업을 위해 정확한 용지 크기를 사용합니다.

이 가이드는 표준 용지 크기 설정, 크기를 다른 인쇄 설정과 결합, 비동기로 인쇄 — 이 모든 것을 작동하는 C# 코드로 수행하는 방법을 다룹니다.

빠른 시작: 용지 크기 설정

  1. NuGet을 통해 IronPrint 설치: Install-Package IronPrint
  2. 파일에 using IronPrint; 추가
  3. PrintSettings 객체 생성
  4. PaperSizePaperSize 열거형의 값으로 설정 (예: PaperSize.A4)
  5. 설정을 Printer.Print() 또는 Printer.PrintAsync()에 전달
  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/IronPrint 설치하기

    PM > Install-Package IronPrint
  2. 다음 코드 조각을 복사하여 실행하세요.

    using IronPrint;
    
    // Print a PDF on A4 paper
    Printer.Print("report.pdf", new PrintSettings
    {
        PaperSize = PaperSize.A4
    });
  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronPrint 사용 시작하기

    arrow pointer

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

우리는 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)
$vbLabelText   $csharpLabel

처음 PrintSettings을 인스턴스화하면 프린터의 기본값으로 초기화됩니다. 그런 다음 표준 8.5 × 11 인치 형식과 일치하는 PaperSizePaperSize.Letter로 재정의합니다. Printer.Print을 호출하면 IronPrint가 해당 용지 크기를 사용하여 시스템의 기본 프린터로 문서를 보냅니다.

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

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

PaperSize 열거형은 ISO 국제 표준, 일반적인 미국 크기, 및 프린터 기본값에 대해 열두 개의 값을 포함합니다. 아래 표는 사용 가능한 모든 옵션을 나열합니다.

열거형 값 기준 치수 (mm) 치수 (in)
PaperSize.A0 ISO A0 841 × 1189 33.1 × 46.8
PaperSize.A1 ISO A1 594 × 841 23.4 × 33.1
PaperSize.A2 ISO A2 420 × 594 16.5 × 23.4
PaperSize.A3 ISO A3 297 × 420 11.7 × 16.5
PaperSize.A4 ISO A4 210 × 297 8.3 × 11.7
PaperSize.A5 ISO A5 148 × 210 5.8 × 8.3
PaperSize.B4 ISO B4 250 × 353 9.8 × 13.9
PaperSize.B5 ISO B5 176 × 250 6.9 × 9.8
PaperSize.Letter US Letter 216 × 279 8.5 × 11.0
PaperSize.Legal US Legal 216 × 356 8.5 × 14.0
PaperSize.Executive US Executive 184 × 267 7.25 × 10.5
PaperSize.PrinterDefault 프린터 기본값 다양한 다양한

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

전체 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)
$vbLabelText   $csharpLabel

이곳에서는 명확성을 위해 객체 초기자 구문을 사용합니다. Orientation은 A4 용지를 더 넓은 축으로 회전 시킵니다. 300에서의 DPI은 차트 및 미세한 텍스트에 대해 선명한 출력을 보장합니다. MarginsMargins 생성자를 통해 밀리미터 단위로 네 가지 값을 받아들입니다 — 상단, 오른쪽, 하단, 왼쪽. 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
$vbLabelText   $csharpLabel

이 클래스 기반 예제는 인쇄 논리를 포함한 실제 패턴을 보여줍니다, DocumentPrinter 서비스는 이를 래핑합니다. 우리는 PaperSize.Legal (8.5 × 14 인치)를 구성하며, 이는 계약 및 법적 제출의 표준 형식입니다. 호출 스레드의 밸런스를 유지하도록 await 키워드를 보장합니다 IronPrint는 인쇄 작업을 처리하는 동안.

이 메서드는 버튼 클릭 핸들러, 백그라운드 서비스 또는 await가 지원되는 곳 어디에서든 호출할 수 있습니다. IronPrint의 비동기 메서드 — PrintAsyncShowPrintDialogAsync를 포함하여 — 동일한 PrintSettings 구성을 받아들이며, 용지 크기 동작은 동기 및 비동기 경로 간에 동일합니다.

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

우리는 IronPrint의 PaperSize 열거형을 사용하여 C#에서 용지 크기를 설정하는 방법을 다루었고, 기본 단일 속성 구성에서 결합 설정 및 비동기 인쇄까지 포괄하였습니다. PrintSettings 클래스는 용지 치수를 추측하는 것 없이 명료하고 강력한 API를 제공합니다.

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

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

PaperOrientation.Landscape

Dpi

PaperMargins

Margins

Grayscale

false

자주 묻는 질문

C#에서 인쇄를 위한 용지 크기 설정에 대해 IronPrint가 어떻게 도움이 됩니까?

IronPrint는 C#에서 인쇄 작업을 간소화하는 라이브러리입니다. A4, Letter 및 Legal과 같은 용지 크기를 쉽게 구성할 수 있게 합니다.

IronPrint를 사용하여 C#에서 사용자 정의 용지 크기를 설정할 수 있습니까?

네, IronPrint는 C#에서 인쇄를 위한 사용자 정의 용지 크기를 설정할 수 있습니다. 특정 인쇄 요구를 충족하는 크기를 정의할 수 있습니다.

IronPrint를 사용하여 A4로 용지 크기를 변경하려면 어떻게 해야 합니까?

A4로 용지 크기를 변경하려면 IronPrint의 용지 크기 설정을 코드에서 구성해야 합니다. IronPrint는 A4 크기를 간단히 설정할 수 있는 방법을 제공합니다.

IronPrint는 Legal 용지 크기 구성을 지원합니까?

네, IronPrint는 C#에서 Legal 용지 크기 구성을 지원합니다. 인쇄 설정 코드 내의 용지 크기 설정을 조정하여 Legal로 쉽게 설정할 수 있습니다.

IronPrint를 사용하여 다양한 용지 크기 간에 전환할 수 있습니까?

물론입니다, IronPrint는 C# 애플리케이션에서 용지 크기 설정을 수정하여 A4, Letter 및 Legal과 같은 다양한 용지 크기 간에 전환할 수 있습니다.

Curtis Chau
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 44,051 | 버전: 2026.7 방금 출시
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package IronPrint
샘플을 실행하세요 문서가 프린터로 전송되는 것을 지켜보세요.