< 상태 바 >

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

// atlctrls.h

typedef CStatusBarCtrlT<ATL::CWindow> CStatusBarCtrl;

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

　WTL의 CStatusBarCtrl클래스는 MFC의 동명의 클래스와 거의 같은 멤버 함수를 준비해 있습니다. 이하에 나타내는 것은 CStatusBarCtrl클래스를 사용하는 예입니다. 프레임 윈도우를 작성해 상태 바를 추가하고 그 상태 바의 2번째 의 페인에 프레임 윈도우의 클라이언트 영역상의 마우스 좌표를 표시합니다.

// 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)

virtual BOOL PreTranslateMessage(MSG* pMsg){

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

}

virtual BOOL OnIdle(){

UIUpdateStatusBar();

return FALSE;

}

BEGIN_UPDATE_UI_MAP(CMainFrame)

// 엔트리 없음

END_UPDATE_UI_MAP()

BEGIN_MSG_MAP_EX(CMainFrame)

MSG_WM_MOUSEMOVE(OnMouseMove)

MSG_WM_SIZE(OnSize)

MSG_WM_CREATE(OnCreate)

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){

// 상태 바를 작성

CreateSimpleStatusBar();

UIAddStatusBar(m_hWndStatusBar);

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

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

void OnSize(UINT uType, CSize size){

// 마우스 좌표를 표시하는 페인의 폭

int cxPosPane = 90;

// 데포르트페인의 폭

CRect rcClient;

GetClientRect(rcClient);

int cxDefaultPane = rcClient.right - cxPosPane

- ::GetSystemMetrics(SM_CXVSCROLL) - ::GetSystemMetrics(SM_CXEDGE);

// 상태 바에 페인을 설정

CStatusBarCtrl bar = m_hWndStatusBar;

int nPanes[] = {cxDefaultPane, cxDefaultPane + cxPosPane};

bar.SetParts(sizeof(nPanes)/sizeof(nPanes[0]), nPanes);

// base class의WM_SIZE메세지 핸들러도 호출하기 (위해)때문에

SetMsgHandled(false);

}

void OnMouseMove(UINT uFlags, CPoint ptClient){

CString strPos;

strPos.Format(_T("X:%d, Y:%d"), ptClient.x, ptClient.y);

CStatusBarCtrl bar = m_hWndStatusBar;

bar.SetText(1, strPos);

}

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;

}

　우선 stdafx.h 에서는 CStatusBarCtrl클래스를 사용하기 위해서 atlctrls.h 헤더를 포함 합니다.

　CMainFrame 클래스에서는 일반적인 프레임 윈도우를 작성해 WM_CREATE 메세지 핸들러로 CreateSimpleStatusBar()를 호출해 상태 바를 작성합니다. 이것에 의해 프레임 윈도우의 멤버 변수인 m_hWndStatusBar에 상태 바의 핸들이 설정됩니다.

　다음에 WM_SIZE 메세지 핸들러를 추가하고 상태 바에 2개의 페인을 추가합니다. 1번째 는 프레임 윈도우의 크기에 맞추어 폭을 조정하는 데포르트 페인, 2번째 는 프레임 윈도우의 클라이언트 영역상의 마우스 좌표를 표시하는 페인입니다. 페인을 설정하려면 SetParts()를 호출합니다. 제1인수에는 페인의 수, 제2인수에는 페인의 우단의 좌표를 요소로 하는 배열에의 포인터를 지정합니다. 덧붙여 WM_SIZE 메세지는 base class인 CFrameWindowImpl클래스내에서도 매핑 되고 있기 때문에 마지막에 SetMsgHandled(false)를 호출할 필요가 있습니다.

　다음으로 WM_MOUSEMOVE 메세지 핸들러를 추가합니다. 여기에서는 클라이언트 좌표를 SetText()에 의해 상태 바의 2번째의 페인(인덱스는1) 에 표시하고 있습니다.

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

멀티 페인 스테이터스 바

위의 예에서는 상태 바에 복수의 페인(멀티 페인) 을 설정하기 위해서 WM_SIZE 메세지 핸들러를 추가해 SetParts()를 호출했습니다. WTL은 이러한 작업을 간략화하기 위해서 CMultiPaneStatusBarCtrl라고 하는 클래스를 준비해 있습니다. CMultiPaneStatusBarCtrl 클래스는 CStatusBarCtrl 클래스의 상속 클래스로 atlctrlx.h 헤더에서는 다음과 같이 정의되고 있습니다. // atlctrlx.h template <class T, class TBase = CStatusBarCtrl> class ATL_NO_VTABLE CMultiPaneStatusBarCtrlImpl : public ATL::CWindowImpl< T, TBase > { ... ... }; class CMultiPaneStatusBarCtrl : public CMultiPaneStatusBarCtrlImpl<CMultiPaneStatusBarCtrl> { public: DECLARE_WND_SUPERCLASS(_T("WTL_MultiPaneStatusBar"), GetWndClassName()) }; 　다음에 나타내는 것은 전술의 프로그램을 CMultiPaneStatusBarCtrl클래스를 사용해 고쳐 쓰는 예입니다. // stdafx.h #include <atlbase.h> #include <atlapp.h> extern CAppModule _Module; #include <atlwin.h> #include <atlcrack.h> #include <atlmisc.h> #include <atlctrls.h> #include <atlctrlx.h> // CMultiPaneStatusBarCtrl클래스를 사용하기 위해 #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) CMultiPaneStatusBarCtrl m_wndStatusBar; virtual BOOL PreTranslateMessage(MSG* pMsg){ return CFrameWindowImpl<CMainFrame>::PreTranslateMessage(pMsg); } virtual BOOL OnIdle(){ UIUpdateStatusBar(); return FALSE; } BEGIN_UPDATE_UI_MAP(CMainFrame) // 엔트리 없음 END_UPDATE_UI_MAP() BEGIN_MSG_MAP_EX(CMainFrame) MSG_WM_MOUSEMOVE(OnMouseMove) MSG_WM_CREATE(OnCreate) 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){ // 상태 바를 작성 m_hWndStatusBar = m_wndStatusBar.Create(m_hWnd); UIAddStatusBar(m_hWndStatusBar); // 상태 바에 페인을 설정 int nPanes[] = {ID_DEFAULT_PANE, IDS_PANE_POS}; m_wndStatusBar.SetPanes(nPanes, sizeof(nPanes)/sizeof(nPanes[0])); // 메시지 루프에 메세지 필터와 아이돌 핸들러를 추가 CMessageLoop* pLoop = _Module.GetMessageLoop(); pLoop->AddMessageFilter(this); pLoop->AddIdleHandler(this); return 0; } void OnMouseMove(UINT uFlags, CPoint ptClient){ CString strPos; strPos.Format(_T("X:%d, Y:%d"), ptClient.x, ptClient.y); m_wndStatusBar.SetPaneText(IDS_PANE_POS, strPos); } 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_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 에서는 CMultiPaneStatusBarCtrl클래스를 사용하기 위해서 atlctrlx.h 헤더를 인클루드 합니다. 　CMainFrame 클래스에서는 CMultiPaneStatusBarCtrl 클래스의 인스턴스를 멤버 변수로서 선언하고 WM_CREATE 메세지 핸들러로 Create() 를 호출하는 것에 의해 멀티 페인 스테이터스 바를 작성합니다. Create()는 반환 값 으로서 상태 바의 핸들을 돌려주므로 그것을 프레임 윈도우의 멤버 변수인 m_hWndStatusBar에 대입합니다. 덧붙여 Create()에는 2개의 버젼이 있어 한쪽은 제2인수에 캐릭터 라인을 지정하는 것, 또 한쪽은 제2인수에 캐릭터 라인 리소스 ID를 지정하는 것입니다. 제2인수를 생략 했을 경우는 후자의 Create()가 불려져 디폴트의 캐릭터 라인 리소스 ID으로서 ATL_IDS_IDLEMESSAGE가 지정됩니다. 양 버젼 모두 제1인수에 부모 윈도우 핸들을 지정하며 제3인수에는 스타일, 제4인수에는 ID를 지정할 수 있습니다. 제3인수를 생략 했을 경우는 디폴트 스타일로서 WS_CHILD | WS_VISIBLE | WS_CLIPCHILDREN | WS_CLIPSIBLINGS | SBARS_SIZEGRIP 가 지정되어 제4인수를 생략 했을 경우는 디폴트ID로서 ATL_IDW_STATUS_BAR가 지정됩니다. 　다음으로 SetPanes()를 호출해 상태 바에 페인을 설정합니다. 제1인수에는 캐릭터 라인 리소스 ID를 요소로 한 배열에의 포인터를 지정하고 제2인수에는 페인의 수를 지정합니다. SetPanes()는 배열내의 캐릭터 라인 리소스 ID 로부터 캐릭터 라인을 취득해 그 캐릭터 라인의 폭과 같은 크기의 페인을 작성합니다. 여기에서는 마우스 좌표를 표시하기 위해서 ID가 IDS_PANE_POS 라고 하는 캐릭터 라인 자원을 준비해 캡션으로서 「X: 0000, Y: 0000」을 설정합니다. 이것은 폭과 높이가 각각 4자리수까지 표시할 수 있는 사이즈의 페인을 작성하는 것을 의미합니다. 덧붙여 배열의 1번째로 지정해 ID_DEFAULT_PANE는 WTL이 준비해 있는 ID로 프레임 윈도우의 사이즈가 변경될 때마다 거기에 맞추어 크기가 조정되는 페인을 의미합니다. 　다음에 WM_MOUSEMOVE 메세지 핸들러에서는 SetPaneText에 의해 상태 바의 ID가 IDS_PANE_POS의 페인에 클라이언트 좌표를 표시하고 있습니다. 　이 예에서는 WM_SIZE 메세지 핸들러를 작성하지 않습니다. 이것은 CMultiPaneStatusBarCtrl클래스 내에는 WM_SIZE 메세지 핸들러가 있으며 프레임 윈도우의 사이즈를 변경할 때마다 상태 바의 페인이 자동적으로 조절되기 때문입니다.