< 스크롤 >

프레임 윈도우의 뷰로써 스크롤 윈도우를 작성합니다. WTL은 스크롤 윈도우를 작성하기 위해서 CScrollWindowImpl라고 하는 템플릿 클래스를 준비해 있습니다. 이 클래스는ATL의 CWindowImpl 클래스와 같이 base class로서의 보고 사용하여 템플릿 인수의 종류도 CWindowImpl클래스와 같습니다.

　이하에 나타내는 것은 CScrollWindowImpl 클래스를 프레임 윈도우의 뷰로써 사용하는 예입니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlframe.h>

#include <atlscrl.h> // 스크롤 윈도우 클래스를 사용하기 위해(때문에)

// view.h

class CScrollView : public CScrollWindowImpl<CScrollView>

{

public:

BOOL PreTranslateMessage(MSG* pMsg){

return FALSE;

}

private:

// 메세지 맵

BEGIN_MSG_MAP_EX(CScrollView)

MSG_WM_CREATE(OnCreate)

CHAIN_MSG_MAP(CScrollWindowImpl<CScrollView>)

CHAIN_MSG_MAP_ALT(CScrollWindowImpl<CScrollView>, 1)

END_MSG_MAP()

LRESULT OnCreate(LPCREATESTRUCT lpcs){

LRESULT lRet = DefWindowProc();

SetScrollSize(640, 480);

SetScrollLine(10, 10);

SetScrollPage(100, 100);

SetMsgHandled(false);

return lRet;

}

void DoPaint(CDCHandle dc){

// 스크롤 윈도우의 중앙에 캐릭터 라인을 묘화

CSize size;

GetScrollSize(size);

CRect rect(0, 0, size.cx, size.cy);

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

-1, rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER);

}

};

// mainfrm.h

class CMainFrame : public CFrameWindowImpl<CMainFrame>,

public CUpdateUI<CMainFrame>, public CMessageFilter, public CIdleHandler

{

public:

DECLARE_FRAME_WND_CLASS(NULL, IDR_MAINFRAME)

CScrollView m_view;

virtual BOOL PreTranslateMessage(MSG* pMsg){

if(CFrameWindowImpl<CMainFrame>::PreTranslateMessage(pMsg))

return TRUE;

return m_view.PreTranslateMessage(pMsg);

}

virtual BOOL OnIdle(){

UIUpdateStatusBar();

return FALSE;

}

BEGIN_UPDATE_UI_MAP(CMainFrame)

// 엔트리 없음

END_UPDATE_UI_MAP()

BEGIN_MSG_MAP_EX(CMainFrame)

MSG_WM_CREATE(OnCreate)

COMMAND_ID_HANDLER_EX(ID_APP_EXIT, OnMenuExit)

CHAIN_MSG_MAP(CUpdateUI<CMainFrame>)

CHAIN_MSG_MAP(CFrameWindowImpl<CMainFrame>)

CHAIN_CLIENT_COMMANDS() // 뷰크라스에 커멘드 체인

END_MSG_MAP()

LRESULT OnCreate(LPCREATESTRUCT lpcs){

// 상태 바를 작성

CreateSimpleStatusBar();

UIAddStatusBar(m_hWndStatusBar);

// 뷰를 작성

m_hWndClient = m_view.Create(m_hWnd, rcDefault, NULL,

WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN,

WS_EX_CLIENTEDGE);

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

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

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

PostMessage(WM_CLOSE);

}

};

// app.cpp

#include "stdafx.h"

#include "resource.h"

#include "view.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;

}

　우선 stdafx.h 에서는 CScrollWindowImpl 클래스를 사용하기 위해서 atlscrl.h 헤더를 인클루드 합니다.

　다음에 뷰 윈도우를 위한 클래스를 정의합니다. 위의 예에서는 프로젝트에 view.h라고 하는 헤더 파일을 추가하여 거기에 CScrollWindowImpl클래스로부터 파생했다. CScrollView 라고 하는 클래스를 정의하고 있습니다.

　CScrollView 클래스 내에서는 메세지 맵을 준비하여 WM_CREATE 메세지 엔트리와 base class에의 체인을 추가합니다. WM_CREATE 메세지 핸들러에서는 스크롤 윈도우의 사이즈나 스크롤 바의 이동량을 설정하여 SetMsgHandled(false)를 호출합니다. 이것은 base class에서도 WM_CREATE 메세지 핸들러가 준비되어 있기 때문입니다.

　다음으로 base class의 멤버 함수 DoPaint()를 오버라이드(override) 합니다. 이 함수는 CScrollWindowImpl 클래스에서 준비되어 있는 WM_PAINT메세지 핸들러로 부터 불려져 여기에 뷰의 묘화 코드를 기술하는 것으로 스크롤 바에 맞추어 묘화 내용도 자동적으로 스크롤 되게 됩니다. 위의 예에서는 스크롤 윈도우의 중앙에 캐릭터 라인을 묘화 하고 있습니다.

　이와 같이 CScrollWindowImpl 클래스에는 메세지 맵이 준비되어 있어 WM_CREATE 메시지나 WM_PAINT메세지 그 외 WM_VSCROLL, WM_HSCROLL, WM_MOUSEWHEEL, WM_SIZE, WM_SETTINGCHANGE, WM_PRINTCLIENT 메세지를 매핑 하고 있기 때문에 적은 작업으로 기본적인 기능을 가진 스크롤 윈도우를 작성할 수가 있습니다.

　그런데 CScrollWindowImpl클래스는 대체 메세지 맵도 준비해 있습니다. 이것은 뷰를 상하 좌우에 스크롤하기 위한 커멘드 메세지를 매핑 하고 있습니다. WTL은 스크롤 윈도우를 조작하기 위해서 디폴트로 다음과 같은 ID를 준비해 있습니다.

ID	조작
ID_SCROLL_UP	상에 스크롤
ID_SCROLL_DOWN	하에 스크롤
ID_SCROLL_PAGE_UP	전의 페이지
ID_SCROLL_PAGE_DOWN	다음의 페이지
ID_SCROLL_TOP	최상부
ID_SCROLL_BOTTOM	최하부
ID_SCROLL_LEFT	왼쪽으로 스크롤
ID_SCROLL_RIGHT	오른쪽으로 스크롤
ID_SCROLL_PAGE_LEFT	왼쪽의 페이지
ID_SCROLL_PAGE_RIGHT	오른쪽의 페이지
ID_SCROLL_ALL_LEFT	왼쪽의 단
ID_SCROLL_ALL_RIGHT	우의 구석

이번 예 에서는 메뉴에ID_SCROLL_UP, ID_SCROLL_DOWN,, D_SCROLL_LEFT, ID_SCROLL_RIGHT의 4개의 아이템을 추가했습니다.



이것에 의해 이러한 메뉴 아이템을 선택하면 커멘드 체인에 의해 커멘드 메세지가 프레임 윈도우로부터 뷰 윈도우에 전송 되어 한층 더 대체 메세지 맵에의 체인에 의해 CScrollWindowImpl클래스의 대체 메세지 맵에 전송 됩니다. CScrollWindowImpl클래스에서는 간접적으로DoScroll()라고 하는 멤버 함수가 불려져 그 함수 내에서 ID마다 스크롤 처리를 합니다.

매핑 방식 스크롤 윈도우

WTL은 매핑 방식에 대응한 스크롤 윈도우용으로 CMapScrollWindowImpl클래스를 준비해 있습니다. 이 클래스는 CScrollWindowImpl클래스에 매핑방식용의 기능이 추가된 것으로 사용법도 CScrollWindowImpl 클래스와 거의 같습니다. 　이하에 나타내는 것은 CMapScrollWindowImpl 클래스로부터 파생한 CMapScrollView 클래스를 작성하는 예입니다. // view.h class CMapScrollView : public CMapScrollWindowImpl<CMapScrollView> { public: BOOL PreTranslateMessage(MSG* pMsg){ return FALSE; } private: // 메세지 맵 BEGIN_MSG_MAP_EX(CMapScrollView) MSG_WM_CREATE(OnCreate) CHAIN_MSG_MAP(CMapScrollWindowImpl<CMapScrollView>) CHAIN_MSG_MAP_ALT(CMapScrollWindowImpl<CMapScrollView>, 1) END_MSG_MAP() LRESULT OnCreate(LPCREATESTRUCT lpcs){ LRESULT lRet = DefWindowProc(); SetScrollMapMode(MM_LOMETRIC); // 매핑방식을 설정 SetScrollSize(640, 480); SetScrollLine(10, 10); SetScrollPage(100, 100); SetMsgHandled(false); return lRet; } void DoPaint(CDCHandle dc){ // 스크롤 윈도우의 중앙에 캐릭터 라인을 묘화 CRect rect; GetScrollSize(rect); dc.DrawText(_T("Hello, ATL/WTL"), -1, rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER); } }; CMapScrollWindowImpl 클래스의 디폴트의 매핑방식은 MM_TEXT입니다. CMapScrollView 클래스에서는 매핑방식을 MM_LOMETRIC로 설정해 있기 때문에 스크롤 윈도우의 논리 단위는 0.1mm에 맵 됩니다

플랫 스크롤 윈도우

WTL은 공용 컨트롤의 플랫 스크롤 바에 대응한 스크롤 윈도우용으로 CFSBWindowT라고 하는 템플릿 클래스를 준비해 있습니다. 템플릿 인수에는 클래스를 지정합니다만 그 클래스는 CFSBWindowT 클래스의 base class인 CFlatScrollBarImpl 클래스의 템플릿 인수로서 사용됩니다. atlscrl.h 헤더에서는 typedef에 의해 다음과 같이 선언되고 있습니다. // atlscrl.h template <class TBase = ATL::CWindow> class CFSBWindowT : public TBase, public CFlatScrollBarImpl<CFSBWindowT< TBase > > { ... }; typedef CFSBWindowT<ATL::CWindow> CFSBWindow; 　이하에 나타내는 것은 CScrollWindowImpl클래스로부터 파생한 CFlatScrollView 클래스를 작성하는 예입니다. CFSBWindow 클래스는 CScrollWindowImpl 클래스의 제2템플릿 인수로 지정합니다. // view.h class CFlatScrollView : public CScrollWindowImpl<CFlatScrollView, CFSBWindow> { public: BOOL PreTranslateMessage(MSG* pMsg){ return FALSE; } private: // 스크롤 사이즈 enum {SCROLL_CX = 640, SCROLL_CY = 480}; // 메세지 맵 typedef CScrollWindowImpl<CFlatScrollView, CFSBWindow> baseClass; BEGIN_MSG_MAP_EX(CFlatScrollView) MSG_WM_SIZE(OnSize) MSG_WM_CREATE(OnCreate) MSG_WM_DESTROY(OnDestroy) CHAIN_MSG_MAP(baseClass) CHAIN_MSG_MAP_ALT(baseClass, 1) END_MSG_MAP() void OnSize(UINT uType, CSize size){ if(size.cx < SCROLL_CX) FlatSB_ShowScrollBar(SB_HORZ); if(size.cy < SCROLL_CY) FlatSB_ShowScrollBar(SB_VERT); SetMsgHandled(false); } LRESULT OnCreate(LPCREATESTRUCT lpcs){ LRESULT lRet = DefWindowProc(); FlatSB_Initialize(); SetScrollSize(SCROLL_CX, SCROLL_CY); SetScrollLine(10, 10); SetScrollPage(100, 100); SetMsgHandled(false); return lRet; } void OnDestroy(){ FlatSB_Uninitialize(); } void DoPaint(CDCHandle dc){ // 스크롤 윈도우의 중앙에 캐릭터 라인을 묘화 CSize size; GetScrollSize(size); CRect rect(0, 0, size.cx, size.cy); dc.DrawText(_T("Hello, ATL/WTL"), -1, rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER); } }; CFSBWindow 클래스를 사용하기 위해서는 atlscrl.h 헤더의 앞에 atlctrls.h 헤더를 인클루드 할 필요가 있습니다. CFlatScrollView 클래스내에서는 WM_CREATE 메세지 핸들러와 WM_DESTROY 메세지 핸들러로 각각 플랫 툴바의 초기화와 종료 처리를 실시하고 있습니다. 덧붙여 이대로는 윈도우를 스크롤 사이즈보다 크게 하고 나서 다시 되돌렸을 경우 스크롤 바가 안보이게 되어 버립니다. 그런데 이번 예에서는 WM_SIZE 메세지 핸들러를 추가해 클라이언트 영역이 스크롤 사이즈보다 작은 경우에 스크롤 바를 가시화하고 있습니다. WTL7.5.4291그리고 추가된 SCRL_DISABLENOSCROLL확장 스타일을 SetScrollExtendedStyle()로 설정하는 것으로 WM_SIZE 메세지 핸들러를 준비할 필요가 없어졌습니다.