통상 도구모음이나 툴바로부터의WM_COMMAND메세지는 메인 윈도우의 메세지 맵이 처리합니다. 그러나 특정의 클래스나 뷰 윈도우의 메세지 맵으로 처리하고 싶은 경우도 있습니다. 그러한 때는 WTL의 커멘드 체인 매크로를 사용합니다. ATL도 몇개의 체인 매크로를 준비해 있습니다만 커멘드 체인 매크로는WM_COMMAND메세지 전용의 체인 매크로입니다.

WTL(은)는 다음과 같은 커멘드 체인 매크로를 준비해 있습니다.

• CHAIN_COMMANDS(클래스명)
  WM_COMMAND메세지를 , 지정된 클래스의 메세지 맵에 체인 합니다.

• CHAIN_COMMANDS_MEMBER(인스턴스명)
  WM_COMMAND메세지를 , 지정된 인스턴스의 메세지 맵에 체인 합니다.

• CHAIN_COMMANDS_ALT(클래스명, 대체 메세지 맵 번호)
  WM_COMMAND메세지를 , 지정된 클래스의 대체 메세지 맵에 체인 합니다.

• CHAIN_COMMANDS_ALT_MEMBER(인스턴스명, 대체 메세지 맵 번호)
  WM_COMMAND메세지를 , 지정된 인스턴스의 대체 메세지 맵에 체인 합니다.

• CHAIN_CLIENT_COMMANDS()
  WM_COMMAND메세지를 ,m_hWndClient그리고 식별되는 뷰윈드우의 메세지 맵에 체인 합니다.

　다음에 나타내는 것은 전회 뷰 윈도우를을 추가한 「Hello, ATL/WTL」프로그램에 커멘드 체인을 추가해 뷰 윈도우 측에서 ID가ID_MENUITEM_HELLO의 커멘드 메세지를 처리하는 예입니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

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

// View.h

class CView : public CWindowImpl<CView>

{

public:

// 메세지 필터 처리

BOOL PreTranslateMessage(MSG* pMsg){

return FALSE;

}

private:

// 메세지 맵

BEGIN_MSG_MAP_EX(CView)

MSG_WM_PAINT(OnPaint)

MSG_WM_CONTEXTMENU(OnContextMenu)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_HELLO, OnMenuHello)

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,

GetParent() // 친윈도우의 핸들

);

}else{

SetMsgHandled(false);

}

}

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

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

}

};

// MainWindow.h

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

class CMyWindow : public CFrameWindowImpl<CMyWindow>,

public CMessageFilter, public CIdleHandler, public CUpdateUI<CMyWindow>

{

public:

// 윈도우 클래스명 , 공통 자원ID을 등록

DECLARE_FRAME_WND_CLASS(_T("Hello"), IDR_MAINFRAME)

// UI갱신 핸들러 맵

BEGIN_UPDATE_UI_MAP(CMyWindow)

UPDATE_ELEMENT(ID_MENUITEM_TOPMOST, UPDUI_MENUPOPUP | UPDUI_TOOLBAR)

END_UPDATE_UI_MAP()

private:

CView m_view;

// 메세지 필터 처리

virtual BOOL PreTranslateMessage(MSG* pMsg){

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

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

return TRUE;

// 뷰윈드우크라스의 것PreTranslateMessage을 호출하는

return m_view.PreTranslateMessage(pMsg);

}

// 아이돌 처리

virtual BOOL OnIdle(){

UIUpdateToolBar();

return FALSE;

}

// 메세지 맵

BEGIN_MSG_MAP_EX(CMyWindow)

MSG_WM_CREATE(OnCreate)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_TOPMOST, OnMenuTopmost)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_EXIT, OnMenuExit)

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

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

CHAIN_CLIENT_COMMANDS() // 뷰윈드우에 체인

END_MSG_MAP()

LRESULT OnCreate(LPCREATESTRUCT lpcs){

// 리버를 작성

CreateSimpleReBar();

// 툴바를 작성해 밴드에 추가

HWND hWndToolBar = CreateSimpleToolBarCtrl(m_hWnd,

IDR_MAINFRAME, FALSE, ATL_SIMPLE_TOOLBAR_PANE_STYLE);

AddSimpleReBarBand(hWndToolBar);

UIAddToolBar(hWndToolBar);

// 상태 바를 작성

CreateSimpleStatusBar();

// 뷰윈드우를 작성

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

WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN,

WS_EX_CLIENTEDGE);

// [항상 앞에 표시]메뉴의 체크 마크 설정

UISetCheck(ID_MENUITEM_TOPMOST, false);

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

CMessageLoop* pLoop = _Module.GetMessageLoop();

pLoop->AddMessageFilter(this);

pLoop->AddIdleHandler(this);

return 0;

}

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

bool bTopmost = !(UIGetState(nID) & UPDUI_CHECKED);

SetWindowPos(bTopmost ? HWND_TOPMOST : HWND_NOTOPMOST,

0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_SHOWWINDOW);

UISetCheck(nID, bTopmost);

}

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

PostMessage(WM_CLOSE);

}

};

// hello.cpp

#include "stdafx.h"

#include "resource.h"

#include "View.h"

#include "MainWindow.h"

CAppModule _Module;

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

{

// 코먼 컨트롤 및 리버 초기화

AtlInitCommonControls(ICC_WIN95_CLASSES | ICC_COOL_CLASSES);

_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;

}

　우선 ID이ID_MENUITEM_HELLO의 커멘드 메세지용 메세지 맵 엔트리와 메세지 핸들러를 CMyWindow클래스에서CView클래스에 이동합니다. 그리고 CMyWindow클래스의 메세지 맵에 CHAIN_CLIENT_COMMANDS() 커멘드 체인 매크로를 추가합니다.

이것에 의해 메인 윈도우인CMyWindow클래스에서 처리되지 않는 ID_MENUITEM_HELLO커멘드 메세지는 뷰 윈도우인 CView클래스에 보내져 CView클래스의 OnMenuHello()이 불려 가게 됩니다.

덧붙여 위의 예에서는CHAIN_CLIENT_COMMANDS()매크로를 사용했습니다만 CHAIN_COMMANDS_MEMBER()매크로에서도 같은 것이 생깁니다. 그 경우는 뷰 윈도우 클래스의 인스턴스를 지정합니다.

CView m_view; // 뷰윈드우의 인스턴스

...

...

// CMyWindow클래스의 메세지 맵

BEGIN_MSG_MAP_EX(CMyWindow)

MSG_WM_CREATE(OnCreate)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_TOPMOST, OnMenuTopmost)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_EXIT, OnMenuExit)

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

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

CHAIN_COMMANDS_MEMBER(m_view) // 뷰윈드우에 체인

END_MSG_MAP()