대부분의 메인 윈도우에는 도구모음이 있어 WM_DESTROY메세지 핸들러에서는 단지PostQuitMessage()를 호출하고 있습니다. 그런데 지금까지 처럼 CWindowImpl클래스를 메인 윈도우의 base class로서 사용하면, 매회 스스로CWndClassInfo구조체를 커스터마이즈 해 메뉴 자원을 설정하거나 메세지 맵에WM_DESTROY메세지용의 엔트리를 추가해 PostQuitMessage()를 호출하기 위해 WM_DESTROY메세지 핸들러를 쓰지 않으면 안됩니다.

　WTL은 이러한 기본적인 기능을 가지는 윈도우를 간단하게 만들기 위해서 CFrameWindowImpl라고 하는 클래스를 준비해 있습니다. CFrameWindowImpl(또는 그 base class이다 FrameWindowImplBase) 클래스에는 WM_DESTROY메세지용의 디폴트의 핸들러가 준비되어 있는 것 외 윈도우 사이즈가 변경되었을 때에 자동적으로 레이아웃을 조정하는WM_SIZE메세지 핸들러 툴바나 상태 바를 작성하는 함수 키보드 가속기용의 코드나 툴 팁용의 메세지 핸들러등이 갖춰져 있습니다. 그리고 도구모음등의 자원을 간단하게 설정하는 매크로를 서포트하고 있습니다.

　여기에서는 전회의 pop-up menu를 추가한 「Hello, ATL/WTL」프로그램의 base class를 CWindowImpl로부터CFrameWindowImpl에 변경해 고쳐 씁니다.

// stdafx.h안

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

#include <atlframe.h> // CFrameWindowImpl클래스를 사용하기 위해(때문에)

// MainWindow.h안

// 메인 윈도우의 base class를CFrameWindowImpl로 변경

class CMyWindow : public CFrameWindowImpl<CMyWindow>,

public CMessageFilter, public CIdleHandler

{

public:

// 윈도우 클래스명 , 공통 자원ID, 스타일 , 배경색을 등록

DECLARE_FRAME_WND_CLASS_EX(_T("Hello"), IDR_MAINFRAME,

CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS, COLOR_WINDOW)

private:

// 메세지 필터 처리

virtual BOOL PreTranslateMessage(MSG* pMsg){

// base class의 것PreTranslateMessage을 호출하는

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

}

// 아이돌 처리

virtual BOOL OnIdle(){

return FALSE;

}

// 메세지 맵

BEGIN_MSG_MAP_EX(CMyWindow)

MSG_WM_PAINT(OnPaint)

MSG_WM_CONTEXTMENU(OnContextMenu)

MSG_WM_CREATE(OnCreate)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_HELLO, OnMenuHello)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_EXIT, OnMenuExit)

CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>) // CFrameWindowImpl클래스에 체인

END_MSG_MAP()

void OnPaint(HDC /*hDC*/){

CPaintDC dc(m_hWnd);

CRect rect;

GetClientRect(rect);

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

rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER);

}

void OnContextMenu(HWND hWnd, CPoint pt){

// [Shift]+[F10]키가 밀렸을 경우는 좌표를 클라이언트 영역의 좌상으로 설정

if(pt.x == -1 && pt.y == -1){

pt.SetPoint(0, 0);

ClientToScreen(&pt);

}

// 좌표가 클라이언트 영역내의 경우만 pop-up menu를 표시

CRect rc;

GetClientRect(&rc);

ClientToScreen(&rc);

if(rc.PtInRect(pt)){

CMenu menuPopup;

menuPopup.LoadMenu(IDR_MENU_POPUP);

menuPopup.GetSubMenu(0).TrackPopupMenu(

TPM_LEFTALIGN | TPM_TOPALIGN | TPM_LEFTBUTTON, pt.x, pt.y, m_hWnd);

}else{

SetMsgHandled(false);

}

}

LRESULT OnCreate(LPCREATESTRUCT lpcs){

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

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

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

MessageBox(_T("Hello, ATL/WTL"));

}

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

PostMessage(WM_CLOSE);

}

};

// hello.cpp내

#include "stdafx.h"

#include "resource.h"

#include "MainWindow.h"

CAppModule _Module;

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

{

_Module.Init(NULL, hInstance);

CMessageLoop theLoop;

_Module.AddMessageLoop(&theLoop);

// 독자 윈도우를 작성

CMyWindow wnd;

wnd.CreateEx();

wnd.ShowWindow(nCmdShow);

wnd.UpdateWindow();

int nRet = theLoop.Run();

_Module.RemoveMessageLoop();

_Module.Term();

return nRet;

}

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

　다음에 , 메인 윈도우인CMyWindow클래스의 base class를 CWindowImpl클래스에서CFrameWindowImpl클래스에 변경합니다. CFrameWindowImpl클래스도CWindowImpl클래스때와 같게 , 3개의 템플릿 인수를 가집니다. 여기에서는 생략 가능한 제2, 3템플릿 인수를 생략 해 제1템플릿 인수에 상속 클래스의 이름을 건네줍니다. 덧붙여 디폴트로 제2템플릿 인수에는CWindow, 제3템플릿 인수에는 윈도우 특성으로서CFrameWinTraits가 건네받습니다. CFrameWinTraits(은)는ATL의atlwin.h헤더로 다음과 같이 정의되고 있습니다.

// atlwin.h내

typedef CWinTraits<WS_OVERLAPPEDWINDOW | WS_CLIPCHILDREN | WS_CLIPSIBLINGS,

WS_EX_APPWINDOW | WS_EX_WINDOWEDGE> CFrameWinTraits;

　CMyWindow클래스에서는 우선 프레임 윈도우용의 윈도우 클래스명 등록 매크로를 사용해 윈도우 클래스명 , 자원ID, 스타일 , 배경색을 등록하고 있습니다. 이 때 자원ID은 이하의 자원으로 공통입니다.

• 윈도우 아이콘
• 도구모음
• 윈도우 타이틀 캐릭터 라인
• 키보드 가속기
• 툴바

즉 , 이러한 자원에 공통의 자원ID을 붙여 그ID를DECLARE_FRAME_WND_CLASS_EX매크로에 의해 등록하면 CFrameWindowImpl클래스는 그러한 자원을 자동적으로 윈도우로 설정합니다. 이번 예에서는 공통 자원ID으로서IDR_MAINFRAME를 사용하기로 했습니다. 그런데 아이콘 자원이나 윈도우 타이틀을 위한 캐릭터 라인 자원을 추가해 각각IDR_MAINFRAME이라고 하는ID을 붙입니다. 그리고 도구모음을 위한 메뉴 자원ID도IDR_MAINFRAME로 변경합니다.



덧붙여 이번 예에서는 툴바나 키보드 가속기는 사용하지 않기 때문에 그것을 위한 자원은 추가하고 있지 않습니다.

　다음에 메세지 필터에서는 base class인CFrameWindowImpl클래스의 것 PreTranslateMessage()을 호출합니다. CFrameWindowImpl::PreTranslateMessage()는 키보드 가속기용으로 ::TranslateAccelerator()를 호출하고 있습니다. 이하는 그 소스입니다.

// atlframe.h안

BOOL PreTranslateMessage(MSG* pMsg)

{

if(m_hAccel != NULL && ::TranslateAccelerator(m_hWnd, m_hAccel, pMsg))

return TRUE;

return FALSE;

}

다만 이번은 키보드 가속기를 사용하지 않기 때문에 너무 관계 없습니다.

　다음에 메세지 맵에 base class인CFrameWindowImpl클래스에 체인을 추가합니다. 이것에 의해 WM_DESTROY메세지에 대한 처리는 CMyWindow클래스가 아니고 CFrameWindowImpl클래스에 맡길 수가 있으므로 상기의 원시 코드로부터는 WM_DESTROY메세지 핸들러용의 코드를 삭제하고 있습니다.

　물론 스스로WM_DESTROY메세지 핸들러를 준비해 거기에 자신의 어플리케이션 특유의 처리를 더할 수가 있습니다. 그 경우 base class인 CFrameWindowImpl클래스에 메세지를 보내는 것을 잊어서는 안됩니다. 그렇게 하지 않으면 최종적으로 ::PostQuitMessage()가 불려 가지 않고 프로그램이 종료하지 않기 때문입니다. 이하는 스스로WM_DESTROY메세지 핸들러를 준비했을 경우의 코드입니다.

// MainWindow.h안

class CMyWindow : public CFrameWindowImpl<CMyWindow>,

public CMessageFilter, public CIdleHandler, public CUpdateUI<CMyWindow>

{

...

// 메세지 맵

BEGIN_MSG_MAP_EX(CMyWindow)

MSG_WM_DESTROY(OnDestroy)

...

...

CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>) // CFrameWindowImpl클래스에 체인

END_MSG_MAP()

...

...

void OnDestroy(){

// 어플리케이션 특유의 처리

...

// 이 함수 호출에 의해 메세지는 체인처의 것CFrameWindowImpl에 보내진다

SetMsgHandled(false);

}

}

　이 예에서는 우선 WM_DESTROY메세지가 보내져 오면 CMyWindow클래스의 메세지 맵의MSG_WM_DESTROY()엔트리에 의해 CMyWindow::OnDestroy()가 실행됩니다. CMyWindow::OnDestroy()그럼 어플리케이션 특유의 처리를 하고 나서 SetMsgHandled(false)를 호출합니다. 이 호출에 의해 한층 더 메세지 맵내가 검색되어 WM_DESTROY메세지는 체인에 의해 base class인CFrameWindowImpl클래스에 보내집니다. CFrameWindowImpl클래스내에서는 한층 더 체인에 의해 base class인CFrameWindowImplBase클래스에 보내져 최종적으로CFrameWindowImplBase클래스의WM_DESTROY메세지 핸들러로 ::PostQuitMessage()가 불려 가 어플리케이션은 종료합니다.

　_tWinMain()는 윈도우를 작성하기 위해서CreateEx()를 사용하고 있습니다. CFrameWindowImpl클래스는Create()도 준비해 있습니다만 공통 자원ID에 의해 자동적으로 자원을 설정하려면 CreateEx()를 사용할 필요가 있습니다.