< 인쇄 작업 >

지금까지의 인쇄 프로그램은 인쇄 코드를 다음과 같이 쓰고 있었습니다.

CPrinterDC dc(m_printerCur, m_devmodeCur);

DOCINFO di = {sizeof(di), _T("WTL에 의한 인쇄 테스트")};

if(dc.StartDoc(&di) > 0){

if(dc.StartPage() > 0){

CRect rect(0, 0, dc.GetDeviceCaps(HORZRES), dc.GetDeviceCaps(VERTRES));

Draw(dc, rect);

if(dc.EndPage() > 0)

dc.EndDoc();

}

}

WTL에서는 일반적인 인쇄 처리(인쇄 작업)를 CPrintJob 클래스와 CPrintJobInfo 클래스에서 캡슐화하고 있습니다. 이러한 클래스를 사용하면 StartDoc()나 StartPage() 를 스스로 쓸 필요는 없습니다. 그리고 인쇄 처리를 다른 thread로 실시하도록 지정할 수가 있습니다. 이하에 나타내는 것은 전회 작성한 프로그램의 인쇄 처리 코드를 CPrintJob클래스와 CPrintJobInfo 클래스를 사용해 고쳐 쓰는 예입니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlframe.h>

#include <atldlgs.h>

#include <atlprint.h>

// mainfrm.h

class CMainFrame : public CFrameWindowImpl<CMainFrame>, public CUpdateUI<CMainFrame>,

public CMessageFilter, public CIdleHandler, public CPrintJobInfo

{

CPrinter m_printerCur; // 현재의 프린터 핸들

CDevMode m_devmodeCur; // 현재의 프린터의 설정

CPrintJob m_job; // 인쇄 작업

public:

DECLARE_FRAME_WND_CLASS_EX(_T("WTL:PrintSample"), IDR_MAINFRAME,

CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS, COLOR_WINDOW)

// constructor　 　

CMainFrame(){

// 디폴트 프린터를 오픈

m_printerCur.OpenDefaultPrinter();

m_devmodeCur.CopyFromPrinter(m_printerCur);

}

virtual BOOL PreTranslateMessage(MSG* pMsg){

return CFrameWindowImpl<CMainFrame>::PreTranslateMessage(pMsg);

}

virtual BOOL OnIdle(){

return FALSE;

}

BEGIN_UPDATE_UI_MAP(CMainFrame)

// 엔트리 없음

END_UPDATE_UI_MAP()

BEGIN_MSG_MAP_EX(CMainFrame)

MSG_WM_PAINT(OnPaint)

MSG_WM_CREATE(OnCreate)

COMMAND_ID_HANDLER_EX(ID_FILE_PRINT, OnFilePrint)

COMMAND_ID_HANDLER_EX(ID_FILE_PRINT_SETUP, OnFilePrintSetup)

COMMAND_ID_HANDLER_EX(ID_APP_EXIT, OnMenuExit)

CHAIN_MSG_MAP(CUpdateUI<CMainFrame>)

CHAIN_MSG_MAP(CFrameWindowImpl<CMainFrame>)

END_MSG_MAP()

virtual bool IsValidPage(UINT nPage){

// 최초의 페이지만 인쇄

return (nPage == 0);

}

virtual bool PrintPage(UINT nPage, HDC hDC){

// 최초의 페이지만 인쇄

if(nPage >= 1)

return false;

CRect rect(0, 0,

::GetDeviceCaps(hDC, HORZRES), ::GetDeviceCaps(hDC, VERTRES));

Draw(hDC, rect);

return true;

}

void Draw(HDC hDC, CRect& rect){

CDCHandle dc(hDC);

dc.DrawText(_T("Hello, ATL/WTL"), -1,

rect, DT_CENTER | DT_VCENTER | DT_SINGLELINE);

}

void OnPaint(HDC /*hDC*/){

CPaintDC dc(m_hWnd);

CRect rect;

GetClientRect(rect);

Draw(dc, rect);

}

LRESULT OnCreate(LPCREATESTRUCT lpcs){

// 메시지 루프에 메세지 필터와 아이돌 핸들러를 추가

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

void OnFilePrint(UINT uNotifyCode, int nID, HWND hWndCtl){

CPrintDialog dlg;

// 다이얼로그를 초기화

dlg.m_pd.hDevMode = m_devmodeCur.CopyToHDEVMODE();

dlg.m_pd.hDevNames = m_printerCur.CopyToHDEVNAMES();

if(dlg.DoModal() == IDOK){

// 프린터의 설정을 보존

m_devmodeCur.CopyFromHDEVMODE(dlg.m_pd.hDevMode);

// 현재의 프린터 핸들을 클로우즈 해 , 새로운 핸들을 오픈

m_printerCur.ClosePrinter();

m_printerCur.OpenPrinter(dlg.m_pd.hDevNames, m_devmodeCur);

// 인쇄 작업을 개시

m_job.StartPrintJob(false, m_printerCur, m_devmodeCur, this,

_T("WTL에 의한 인쇄 테스트"), 0, 0, (dlg.PrintToFile() != FALSE));

}

// 다이얼로그의 초기화로 할당한 메모리를 해방

::GlobalFree(dlg.m_pd.hDevMode);

::GlobalFree(dlg.m_pd.hDevNames);

}

void OnFilePrintSetup(UINT uNotifyCode, int nID, HWND hWndCtl){

CPageSetupDialog dlg;

// 다이얼로그를 초기화

dlg.m_psd.hDevMode = m_devmodeCur.CopyToHDEVMODE();

dlg.m_psd.hDevNames = m_printerCur.CopyToHDEVNAMES();

if(dlg.DoModal() == IDOK){

// 프린터의 설정을 보존

m_devmodeCur.CopyFromHDEVMODE(dlg.m_psd.hDevMode);

// 현재의 프린터 핸들을 클로우즈 해 , 새로운 핸들을 오픈

m_printerCur.ClosePrinter();

m_printerCur.OpenPrinter(dlg.m_psd.hDevNames, m_devmodeCur);

}

// 다이얼로그의 초기화로 할당한 메모리를 해방

::GlobalFree(dlg.m_psd.hDevMode);

::GlobalFree(dlg.m_psd.hDevNames);

}

void OnMenuExit(UINT uNotifyCode, int nID, HWND hWndCtl){

PostMessage(WM_CLOSE);

}

};

// app.cpp

#include "stdafx.h"

#include "resource.h"

#include "mainfrm.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE, LPTSTR lpCmdLine, int nCmdShow)

{

HRESULT hRes = ::CoInitialize(NULL);

ATLASSERT(SUCCEEDED(hRes));

::DefWindowProc(NULL, 0, 0, 0L);

AtlInitCommonControls(ICC_COOL_CLASSES | ICC_WIN95_CLASSES);

hRes = _Module.Init(NULL, hInstance);

ATLASSERT(SUCCEEDED(hRes));

int nRet = 0;

// BLOCK: 어플리케이션 실행

{

CMessageLoop theLoop;

_Module.AddMessageLoop(&theLoop);

CMainFrame wnd;

wnd.CreateEx();

wnd.ShowWindow(nCmdShow);

wnd.UpdateWindow();

nRet = theLoop.Run();

_Module.RemoveMessageLoop();

}

_Module.Term();

::CoUninitialize();

return nRet;

}

　우선 CPrintJobInfo 클래스를 CMainFrame 클래스의 base class에 추가합니다. 이 CPrintJobInfo 클래스에는 몇 개의 가상 함수가 준비되어 있어 CPrintJobInfo 클래스의 상속 클래스는 그것들을 오버라이드(override) 해 인쇄 처리를 기술합니다. CPrintJobInfo클래스가 준비해 있는 가상 함수를 이하에 나타냅니다.

함수명	해설
BeginPrintJob	인쇄 처리를 개시하기 전(StartDoc()가 불려 간 직후) 의 처리
EndPrintJob	인쇄 처리를 종료한 후 (EndDoc()가 불려 가기 직전) 의 처리
PrePrintPage	페이지를 인쇄하기 전(StartPage()가 불려 간 직후) 의 처리
PostPrintPage	페이지를 인쇄한 후 (EndPage()가 불려 가기 직전) 의 처리
PrintPage	페이지의 인쇄 처리
GetNewDevModeForPage	페이지 독자적인DEVMODE에의 포인터를 취득
IsValidPage	페이지가 유효한지 어떤지를 지시

이 안에서 PrintPage()는 순수 가상 함수이기 때문에 반드시 오버라이드(override) 할 필요가 있습니다. 이번 예 에서는 CPrintJobInfo 클래스의 상속 클래스인 CMainFrame 클래스에서 IsValidPage()라고 PrintPage()를 오버라이드(override) 합니다.

IsValidPage()은 페이지 번호가 0의 경우만 true을 돌려주어 인쇄 작업을 계속하는 것을 지시합니다. 이것은 이번 프로그램은 최초의 페이지 밖에 인쇄하지 않기 때문입니다.

PrintPage()은 현재의 페이지 번호를 확인해 Draw()를 호출해 인쇄를 실시하고 있습니다.

　다음에 CPrintJob 클래스의 인스턴스를 CMainFrame 클래스의 멤버 변수로서 선언합니다.

　다음에 메뉴 아이템 [인쇄](ID：ID_FILE_PRINT) 용의 커멘드 메세지 핸들러를 변경합니다. 이 핸들러 에서는 CPrintJob 클래스의 멤버 함수인 StartPrintJob()을 호출해 인쇄 작업을 개시합니다. StartPrintJob()의 인수는 순서에 인쇄 작업을 위해서 thread를 기동하는지 어떤지를 나타내는 bool값, 프린터 핸들 DEVMODE에의 포인터, IPrintJobInfo 클래스에의 포인터, 문서명, 개시 페이지 번호, 종료 페이지 번호, 파일에 출력하는지 어떤지를 나타내는 bool값, 출력 파일명을 지정할 수 있습니다. 덧붙여 제 4인수의 IPrintJobInfo 클래스란 CPrintJobInfo 클래스의 base class 입니다. 이번 예에서는 CMainFrame 클래스는 CPrintJobInfo 클래스의 상속 클래스이기 때문에 CMainFrame 클래스는 간접적으로 IPrintJobInfo클래스의 상속 클래스라는 것이 됩니다.