< Pager >

WTL은 공용 컨트롤의 pager 컨트롤을 CPagerCtrlT 이라고 하는 템플릿 클래스에서 캡슐화 하고 있습니다. 템플릿 인수에는 클래스를 지정합니다만 그 클래스는 CPagerCtrlT 클래스의 base class로서 사용됩니다. atlctrls.h 헤더에서는 typedef에 의해 다음과 같이 선언되고 있습니다.

// atlctrls.h

typedef CPagerCtrlT<ATL::CWindow> CPagerCtrl;

이것은 CPagerCtrl 클래스는 CWindow 클래스의 상속 클래스인 것을 의미합니다.

　이하에 나타내는 것은 CPagerCtrl클래스를 사용하는 예 입니다. 프레임 윈도우를 작성해 그 툴바에 pager를 사용합니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlctrls.h> // 컨트롤용 클래스를 사용하기 위해

#include <atlframe.h>

// mainfrm.h

class CMainFrame : public CFrameWindowImpl<CMainFrame>,

public CUpdateUI<CMainFrame>, public CMessageFilter, public CIdleHandler

{

public:

DECLARE_FRAME_WND_CLASS(NULL, IDR_MAINFRAME)

enum { IDC_PAGER_BAR = 1001 };

CPagerCtrl m_pager_bar;

CSize m_sizeToolbar; // 툴바의 사이즈

virtual BOOL PreTranslateMessage(MSG* pMsg){

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

}

virtual BOOL OnIdle(){

UIUpdateToolBar();

return FALSE;

}

BEGIN_UPDATE_UI_MAP(CMainFrame)

// 엔트리 없음

END_UPDATE_UI_MAP()

BEGIN_MSG_MAP_EX(CMainFrame)

MSG_WM_CREATE(OnCreate)

NOTIFY_HANDLER_EX(IDC_PAGER_BAR, PGN_CALCSIZE, OnPagerCalcsize)

NOTIFY_HANDLER_EX(IDC_PAGER_BAR, PGN_SCROLL, OnPagerScroll)

COMMAND_ID_HANDLER_EX(ID_APP_EXIT, OnMenuExit)

CHAIN_MSG_MAP(CUpdateUI<CMainFrame>)

CHAIN_MSG_MAP(CFrameWindowImpl<CMainFrame>)

END_MSG_MAP()

LRESULT OnCreate(LPCREATESTRUCT lpcs){

// 리버를 작성

CreateSimpleReBar();

// pager 컨트롤을 작성

m_pager_bar.Create(m_hWndToolBar, NULL, NULL,

WS_CHILD | WS_VISIBLE | PGS_HORZ, 0, IDC_PAGER_BAR);

// 툴바를 작성

HWND hWndToolBar = CreateSimpleToolBarCtrl(m_pager_bar.m_hWnd,

IDR_MAINFRAME, FALSE, ATL_SIMPLE_TOOLBAR_PANE_STYLE);

UIAddToolBar(hWndToolBar);

// 툴바의 사이즈를 취득

::SendMessage(hWndToolBar, TB_GETMAXSIZE, 0, (LPARAM)&m_sizeToolbar);

m_pager_bar.MoveWindow(0, 0, m_sizeToolbar.cx, m_sizeToolbar.cy);

m_pager_bar.SetChild(hWndToolBar);

m_pager_bar.SetBkColor(RGB(240, 240, 255));

AddSimpleReBarBand(m_pager_bar.m_hWnd, _T("pager 첨부 툴바"));

// 상태 바를 작성

CreateSimpleStatusBar();

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

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

LRESULT OnPagerCalcsize(LPNMHDR pnmh){

LPNMPGCALCSIZE pCalcSize = (LPNMPGCALCSIZE)pnmh;

switch(pCalcSize->dwFlag){

case PGF_CALCWIDTH:

pCalcSize->iWidth = m_sizeToolbar.cx;

break;

}

return 0;

}

LRESULT OnPagerScroll(LPNMHDR pnmh){

LPNMPGSCROLL pScroll = (LPNMPGSCROLL)pnmh;

switch(pScroll->iDir){

case PGF_SCROLLLEFT:

case PGF_SCROLLRIGHT:

case PGF_SCROLLUP:

case PGF_SCROLLDOWN:

pScroll->iScroll = 10;

break;

}

return 0;

}

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

PostMessage(WM_CLOSE);

}

};

// Control.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_PAGESCROLLER_CLASS);

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;

}

　우선 stdafx.h 에서는 CPagerCtrl 클래스와 프레임 윈도우를 사용하기 위해서 atlctrls.h 헤더와 atlframe.h 헤더를 포함 합니다.

　CMainFrame 클래스에서는 일반적인 프레임 윈도우를 작성하는 것에 더해 pager 컨트롤용으로 ID(IDC_PAGER_BAR) 를 정의해 CPagerCtrl 클래스의 인스턴스를 멤버 변수로서 선언합니다. 이것을 사용하기 위해서는 WM_CREATE 메세지 핸들러로 Create()를 호출해 작성할 필요가 있습니다. 그리고 툴바의 사이즈를 나타내는 CSize 클래스의 인스턴스도 멤버 변수로서 선언해 둡니다.

　다음에 WM_CREATE 메세지 핸들러로 우선 CreateSimpleReBar()을 호출해 리버를 작성합니다. 다음에 리버를 부모로서 즉 Create()의 제1인수에 리버의 핸들m_hWndToolBar을 지정해 pager 컨트롤을 작성합니다. 게다가 pager 컨트롤을 부모로서 툴바를 작성합니다. 이 때 스타일로서 CCS_NORESIZE를 지정할 필요가 있습니다. (ATL_SIMPLE_TOOLBAR_PANE_STYLE 에는 CCS_NORESIZE 스타일이 포함되어 있습니다.) 다음으로 pager 컨트롤의 사이즈를 툴바와 같은 사이즈로 해 SetChild()에 툴바의 핸들을 지정하는 것에 따라 툴바를 pager 컨트롤의 자식으로 설정합니다. 그리고 SetBkColor에 의해 pager 컨트롤의 색을 지정해 있습니다. 이렇게 작성한 pager 컨트롤을AddSimpleReBarBand에 의해 리버에 추가합니다.

　다음에 통지 코드가 PGN_CALCSIZE의 pager 컨트롤용 통지 메세지 핸들러를 추가합니다. 이 핸들러에서는 pager 컨트롤의 사이즈를 툴바의 폭과 같은 사이즈로 설정합니다. 이 핸들러는 필수입니다.

　다음에 통지 코드가 PGN_SCROLL의 pager 컨트롤용 통지 메세지 핸들러를 추가합니다. 이 핸들러에서는 pager 컨트롤의 스크롤치를 설정합니다.

　마지막으로 _tWinMain()에서 ICC_PAGESCROLLER_CLASS 플래그를 지정해 AtlInitCommonControls()를 호출합니다. 이것에 의해 pager 컨트롤이 사용 가능하게 됩니다.