29-1.인쇄 관련 클래스

29-1-1.인쇄 대화상자

인쇄는 여러 모로 어려운 작업이다. 프린터마다 제어 명령이 다르고 용지와 화면의 해상도 차이도 심해 화면에서와 똑같은 모양으로 인쇄하기 쉽지 않다. 또 용지 걸림이나 잉크 떨어짐 같은 예기치 못한 예외 상황이 많아 섬세한 에러 처리까지 요구된다. 다행스럽게도 대부분은 운영체제와 고수준 라이브러리가 흡수하므로 닷넷에서 인쇄는 그다지 어렵지 않다.

인쇄 자체보다 더 어려운 것은 인쇄에 필요한 옵션 정보를 입력받는 것이다. 프린터 선택, 인쇄 범위, 인쇄 옵션, 용지 선택 등 다양한 정보를 입력받아야 한다. 다행히 닷넷은 이런 정보를 대신 입력받는 PrintDialog 공통 대화상자를 제공하므로 어렵지 않게 입력받을 수 있다. 다음은 PrintDialog의 프로퍼티이다.

프로퍼티	타입	설명
AllowCurrentPage	bool	현재 페이지 옵션을 표시한다.
AllowPrintToFile	bool	파일로 인쇄 옵션을 표시한다.
AllowSelection	bool	선택 영역 인쇄 옵션을 표시한다.
AllowSomePages	bool	인쇄 범위를 지정하는 페이지 옵션을 선택할 수 있다.
PrintToFile	bool	파일로 인쇄 옵션의 선택 여부를 지정한다.
ShowHelp	bool	도움말 버튼을 표시한다.
ShowNetwork	bool	네트웍 버튼을 표시한다. 이 버튼이 있으면 네트웍에 연결된 프린터로도 인쇄할 수 있다.
UseExDialog	bool	확장된 인쇄 대화상자를 보여준다.
Document	PrintDocument	프린터 설정 정보를 가져올 PrintDocument 객체이다.
PrinterSettings	PrinterSettings	프린터 설정 정보를 가지는 PrinterSettings 객체이다.

주로 인쇄 대화상자에 어떤 옵션을 표시할 것인가를 지정한다. 인쇄 대화상자의 컨트롤과 PrintDialog 클래스의 프로퍼티간 대응관계를 그림으로 그려 보았다. 프로그램이 지원하는 인쇄 옵션에 따라 필요한 컨트롤을 표시하거나 숨기면 된다. 예를 들어 선택 영역만 인쇄하는 기능을 지원하지 않는다면 AllowSelection 프로퍼티를 false로 변경한다.

인쇄 대화상자를 통해 입력받은 정보는 PrinterSettings 프로퍼티를 통해 읽을 수 있는데 이 프로퍼티는 같은 이름인 PrinterSettings 클래스 타입이다. 이 클래스에는 인쇄와 관련된 정보가 들어 있는데 크게 프린터에 관련된 정보와 인쇄 옵션에 관련된 정보로 분류할 수 있다. 먼저 프린터에 관련된 프로퍼티부터 정리해 보자.

프로퍼티	타입	설명
PrinterName	string	사용할 프린터의 이름을 조사하거나 설정한다. 코드에서 직접 이름을 지정할 수도 있는데 이때 IsValid 프로퍼티로 유효한 프린터인지 확인해야 한다.
IsDefaultPrinter	bool ⓡ	기본 프린터인지 조사한다.
IsPlotter	bool ⓡ	플로터인지 조사한다. 플로터는 벡터 장비이므로 비트맵을 출력하지 못한다.
IsValid	bool ⓡ	PrinterName 프로퍼티가 올바른 프린터인지 검사한다.
CanDuplex	bool ⓡ	프린터가 양면 인쇄를 지원하는지 조사한다.
Duplex	Duplex	양면 인쇄에 대한 옵션을 조사하거나 설정한다.
DefaultPageSettings	PageSettings ⓡ	선택한 프린터의 기본 페이지 설정을 조사한다.
LandScapeAngle	int ⓡ	세로 방향을 가로로 찍을 때 회전되는 각도를 조사한다. 90도나 270도로 회전할 수 있으며 가로 방향을 지원하지 않으면 0도가 리턴된다.
PaperSizes	PaperSizeCollection ⓡ	프린터가 지원하는 용지 크기의 목록을 조사한다.
PaperSources	PaperSourceCollection ⓡ	프린터가 지원하는 급지 장치의 목록을 조사한다.
PrinterResolutions	PrinterResolutionCollection ⓡ	프린터가 지정하는 모든 해상도를 조사한다.
SupportsColor	bool ⓡ	컬러 인쇄를 지원하는지 조사한다.
InstalledPrinters	StringCollection ⓡⓢ	설치된 모든 프린터의 이름을 조사한다. 프린터 열거에 해당한다.

프린터의 능력치에 대한 정보인데 대부분 읽기 전용이다. 컬러 인쇄, 양면 인쇄, 지원하는 용지 등의 정보를 얻을 수 있다. 다음은 사용자가 선택한 인쇄 옵션에 대한 프로퍼티이다.

프로퍼티	타입	설명
PrintRange	PrintRange	인쇄 범위이다. AllPages, CurrentPage, Selection, SomePages 중 하나이다. SomePages인 경우 FromPage ~ ToPage까지 인쇄된다.
FromPage	int	인쇄를 시작할 페이지 번호이다.
ToPage	int	인쇄할 마지막 페이지이다.
Copies	short	인쇄 매수이다.
Collate	bool	여러부 인쇄시 한부씩 인쇄되는지를 나타낸다.
MaximumCopies	int	한 번에 인쇄할 수 있는 최대 매수를 조사한다.
MinimumPage	int	선택할 수 있는 최소 페이지이다.
MaximumPage	int	선택할 수 있는 최대 페이지이다.
PrintToFile	bool	파일로 인쇄 옵션의 선택 여부를 지정한다.
PrintFileName	string	파일로 인쇄할 경우 저장할 파일명이다.

대화상자를 열기 전에 프로퍼티에 값을 미리 대입하면 대화상자가 열린 직후에 이 값이 표시된다. 문서의 범위가 1 ~ 12페이지까지라면 FromPage에 1을, ToPage에 12를 대입해 두면 대화상자가 열리자 마자 1-12로 입력되어 있다. 이 범위를 받아 들이면 두 프로퍼티는 초기값이 리턴되며 편집했다면 편집된 범위가 리턴된다.

PrintOption

using System; ~ using System.Windows.Forms;

using System.Drawing.Printing;

namespace PrintOption {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

private void button1_Click(object sender, EventArgs e) {

if (printDialog1.ShowDialog() == DialogResult.OK) {

PrinterSettings PS = printDialog1.PrinterSettings;

listBox1.Items.Clear();

listBox1.Items.Add("인쇄할 프린터 : " + PS.PrinterName);

listBox1.Items.Add("인쇄 매수 : " + PS.Copies);

listBox1.Items.Add("한부씩 인쇄 : " + PS.Collate);

switch (PS.PrintRange) {

case PrintRange.AllPages:

listBox1.Items.Add("문서 전체 인쇄");

break;

case PrintRange.CurrentPage:

listBox1.Items.Add("현재 페이지 인쇄");

break;

case PrintRange.Selection:

listBox1.Items.Add("선택 영역 인쇄");

break;

case PrintRange.SomePages:

listBox1.Items.Add(PS.FromPage + " ~ " + PS.ToPage + "까지 인쇄");

break;

}

if (PS.PrintToFile) {

PS.PrintFileName = @"C:\Spool.prn";

listBox1.Items.Add(PS.PrintFileName + " 파일에 인쇄");

}

}

}

}

}

이 예제는 인쇄 공통 대화상자를 호출하여 인쇄 관련 옵션을 입력받아 그 결과를 리스트 박스에 출력한다. 인쇄 관련 클래스는 대부분 System.Drawing.Printing 네임스페이스에 정의되어 있다. 폼에는 버튼 하나와 리스트 박스를 배치해 두었고 트레이에는 PrintDialog 컴포넌트를 배치했다.

PrintDialog의 Allow* 프로퍼티는 모두 true로 변경하여 가급적 많은 옵션을 입력받을 수 있도록 했다. 버튼을 클릭하면 ShowDialog 메서드로 인쇄 대화상자를 띄우고 사용자가 선택한 인쇄 옵션을 리스트 박스에 문자열 형태로 조립하여 출력한다. 선택하는 옵션에 따라 리스트 박스에 출력되는 내용이 달라진다.

이 예제는 인쇄 대화상자를 통해 인쇄 옵션을 입력받는 데까지만 처리한다. 이후 입력받은 옵션대로 문서의 내용을 인쇄하는 코드가 따라 와야 한다.

29-1-2.페이지 설정 대화상자

인쇄에 필요한 또 다른 옵션은 용지에 대한 설정이다. 인쇄는 용지에 대한 출력이므로 용지의 크기나 방향, 상하좌우 여백에 대한 옵션도 지대한 영향을 미친다. 이 옵션은 비단 인쇄에만 사용하는 것이 아니라 편집에도 참조하므로 미리 입력받아 놓는 것이 보통이다. 용지에 대한 설정을 알아야 편집 화면을 최종 인쇄 문서와 비슷하게 표시할 수 있다.

용지에 대한 설정을 표시하고 입력받는 PageSetupDialog 컨트롤을 사용하면 필요한 대부분의 옵션을 입력받을 수 있다. 이 대화상자보다 더 상세한 옵션을 입력받아야 한다면 직접 대화상자를 만들어야 한다. 상용 워드프로세서는 페이지 설정이 굉장히 복잡해 커스텀 대화상자를 사용한다. PageSetupDialog는 프로퍼티로 어떤 옵션을 입력받을 것인가를 지정하기도 하고 사용자가 선택한 옵션을 돌려 받기도 한다.

프로퍼티	타입	설명
AllowMargins	bool	여백을 지정할 수 있다.
AllowOrientation	bool	용지의 방향을 지정할 수 있다.
AllowPaper	bool	용지의 크기를 선택할 수 있다.
AllowPrinter	bool	프린터를 선택할 수 있다.
Document	PrintDocument	페이지 설정을 가져올 PrintDocument 객체이다.
EnableMetric	int	밀리미터 단위로 표시되는 여백이 1/100인치 단위로 변환되는가를 지정한다.
MinMargins	Margins	선택할 수 있는 최소 여백이다.
PageSettings	PageSettings	수정 대상이 되는 페이지 설정 객체이다. 대화상자를 호출하기 전에 미리 생성해 두어야 한다.
PrinterSettings	PrinterSettings	수정 대상이 되는 프린터 설정 객체이다. 대화상자를 호출하기 전에 미리 생성해 두어야 한다.
ShowHelp	bool	도움말 버튼을 표시한다.
ShowNetwork	bool	네트웍 버튼을 표시한다.

PageSettings 객체와 PrinterSettings 객체는 대화상자를 호출하기 전에 미리 생성하여 대입해 두어야 한다. 이 두 객체의 상태가 대화상자에 표시되고 사용자가 입력한 결과도 이 객체를 통해 리턴된다. PageSettings 클래스는 페이지 정보를 표현하는데 페이지 설정 대화상자는 결국 이 객체를 만들어 낸다. 다음은 PageSettings의 프로퍼티이다.

프로퍼티	타입	설명
Bounds	Rectangle ⓡ	페이지의 크기를 조사한다.
Color	bool	컬러로 인쇄할 것인지를 나타낸다.
LandScape	bool	가로 방향으로 인쇄할 것인지를 나타낸다.
Margins	Margins	페이지의 여백을 표현하는 Margin 객체이다.
PaperSize	PaperSize	용지의 크기를 나타낸다.
PaperSource	PaperSource	용지 공급 장치를 나타낸다.
PrintableArea	RectangleF ⓡ	인쇄 가능한 페이지 영역을 조사한다.
PrinterResolution	PrinterResolution	프린터의 해상도를 조사한다.
PrinterSettings	PrinterSettings	프린터의 설정 정보를 조사한다.

용지의 크기, 방향, 여백 등의 정보로 구성되어 있다. 다음 예제는 페이지 설정 대화상자에서 사용자가 선택한 정보를 리스트 박스에 출력한다.

PageSetup

using System; ~ using System.Windows.Forms;

using System.Drawing.Printing;

namespace PageSetup {

public partial class Form1 : Form {

public Form1() {

InitializeComponent();

}

private void button1_Click(object sender, EventArgs e) {

pageSetupDialog1.PageSettings = new PageSettings();

pageSetupDialog1.PrinterSettings = new PrinterSettings();

if (pageSetupDialog1.ShowDialog() == DialogResult.OK) {

PageSettings PS = pageSetupDialog1.PageSettings;

listBox1.Items.Clear();

listBox1.Items.Add("가로 방향 인쇄 : " + PS.Landscape);

listBox1.Items.Add("용지 종류 : " + PS.PaperSize.Kind);

listBox1.Items.Add("급지 장치 : " + PS.PaperSource.Kind);

listBox1.Items.Add("여백 : " + PS.Margins);

listBox1.Items.Add("용지 크기 : " + PS.Bounds);

listBox1.Items.Add("컬러 인쇄 : " + PS.Color);

}

}

}

}

버튼을 누르면 페이지 설정 대화상자를 호출하고 그 결과를 리스트 박스에 문자열로 조립해서 출력한다. new 연산자로 PageSettings 객체와 PrinterSettings 객체를 생성해서 전달하되 디폴트 생성자를 사용했으므로 무난한 설정과 기본 프린터에 대한 정보가 나타난다.

사용자는 이 대화상자에서 용지의 크기나 급지 장치, 상하좌우의 여백 등을 편집하며 이 정보는 문서를 편집하거나 인쇄할 때 사용한다.

29-1-3.PrintDocument

PrintDocument 클래스는 인쇄할 문서를 표현한다. 문서에 대한 몇 가지 정보를 프로퍼티로 제공하며 문서 인쇄 절차에 대한 이벤트를 정의한다. 이 객체를 생성하여 문서의 속성을 정의하고 각 페이지에 대한 인쇄 코드를 작성한다. 다음은 프로퍼티 목록이다.

프로퍼티	타입	설명
DocumentName	string	인쇄할 문서의 이름이다. 프린터 큐에 이 문서의 이름이 표시된다. 기본값은 "문서"인데 의미있는 이름을 붙이는 것이 좋다.
DefaultPageSettings	PageSettings	인쇄할 모든 페이지에 기본적으로 적용될 PageSettings 객체이다. 각 페이지의 설정은 개별적으로 수정할 수 있다.
OriginAtMargins	bool	그래픽 개체의 위치가 여백 내에 있는지 조사한다.
PrintController	PrintController	인쇄를 도와줄 컨트롤러이다. 인쇄 과정을 대화상자로 보여주고 중간에 취소할 수 있는 버튼을 표시한다.
PrinterSettings	PrinterSettings	문서를 인쇄할 프린터에 관한 정보이다.

문서안에 페이지 설정 정보와 프린터 설정 정보가 모두 포함되어 있다. 또한 페이지 설정 정보 안에도 프린터 설정 정보가 포함되어 있다. 객체간의 편리한 참조를 위해서이지만 중첩이 심해 처음 보는 사람은 무척 헷갈리는 구조이다. 다른 프로퍼티는 디폴트를 그냥 사용하더라도 DocumentName 프로퍼티는 꼭 변경하는 것이 좋다. 이벤트는 다음 네 가지가 있는데 인쇄가 진행될 때 차례대로 전달된다.

이벤트	설명
BeginPrint	인쇄를 시작하기 전에 발생한다. 이 이벤트에서 인쇄 중에 사용할 글꼴이나 파일 등의 리소스를 초기화한다. 인수로 전달된 객체의 Cancel 프로퍼티에 true를 대입하면 인쇄를 취소할 수 있다.
PrintPage	한 페이지를 인쇄할 때 발생한다. 인수로 전달된 Graphics 객체로 출력을 내 보내면 된다.
EndPrint	인쇄를 끝낼 때 발생한다. BeginPrint에서 준비한 리소스를 해제한다.
QueryPageSettings	PrintPage 이벤트 직전에 발생하며 페이지별로 설정을 변경할 기회를 제공한다. 특정 페이지만 가로로 찍는다거나 흑백으로 인쇄하도록 설정할 수 있다.

PrintPage 이벤트로 PrintPageEventArgs 객체가 인수로 전달된다. 이 객체에는 인쇄에 사용할 Graphics 객체가 전달되는데 이 객체의 출력 메서드를 호출하여 용지에 그림을 그린다. 마치 Paint 이벤트의 인수로 화면 그리기에 필요한 Graphics 객체가 전달되는 것과 같다. Graphics 객체는 페이지별로 매번 새로 생성되므로 설정 상태를 바꿔도 다음 페이지에 영향을 미치지 않는다.

PrintPageEventArgs 객체에는 인쇄할 페이지에 대한 정보인 PageSettings, PageBounds, MarginBounds 프로퍼티도 포함되어 있고 인쇄 취소를 위한 Cancel 프로퍼티도 있다. 인쇄를 중간에 취소하려면 Cancel 프로퍼티에 true를 대입하는데 이 경우 프린터 큐에 스풀링된 것까지 모두 취소된다. 다음 페이지가 있다는 것을 알리려면 HasMorePages 프로퍼티에 true를 대입하며 이 경우 PrintPage 이벤트가 계속 발생한다.

PrintDocument의 메서드는 Print 하나 뿐이다. 이 메서드를 호출하면 BeginPrint 이벤트로 인쇄를 준비하고 각 페이지에 대해 PrintPage 이벤트를 발생시킨다. 응용 프로그램은 이 이벤트를 받았을 때 해당 페이지를 인쇄한다. Print 메서드는 인쇄가 완전히 끝나거나 취소되기 전에는 리턴하지 않는다. 즉, 프로그램의 흐름을 블록시킨다.