UI갱신 핸들러란 적절한 타이밍(아이들 시나 WM_INITMENUPOPUP메세지가 보내져 왔을 때 등 ) 에 UI상태를 갱신하기 위한 구조입니다. 예를 들면 메뉴 아이템에 체크 마크를 넣거나 툴바 버튼을 사용 불가로 할 때 등에 사용합니다. UI갱신 핸들러는WTL의CUpdateUI클래스에 의해 실현됩니다.

　여기에서는 전회의 상태 바를 추가한 「Hello, ATL/WTL」프로그램의 도구모음에 [항상 앞에 표시]라고 하는 메뉴 아이템을 추가합니다. 이 때 메뉴 아이템이 선택될 때마다 UI갱신 핸들러에 의해 메뉴 아이템의 체크 마크의 부가와 소거를 반복하도록 합니다.

// 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 CUpdateUI<CMyWindow>

{

public:

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

DECLARE_FRAME_WND_CLASS_EX(_T("Hello"), IDR_MAINFRAME,

CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS, COLOR_WINDOW)

// UI갱신 핸들러 맵

BEGIN_UPDATE_UI_MAP(CMyWindow)

UPDATE_ELEMENT(ID_MENUITEM_TOPMOST, UPDUI_MENUPOPUP)

END_UPDATE_UI_MAP()

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_TOPMOST, OnMenuTopmost)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_HELLO, OnMenuHello)

COMMAND_ID_HANDLER_EX(ID_MENUITEM_EXIT, OnMenuExit)

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

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

// 리버를 작성

CreateSimpleReBar();

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

HWND hWndToolBar = CreateSimpleToolBarCtrl(m_hWnd,

IDR_MAINFRAME, FALSE, ATL_SIMPLE_TOOLBAR_PANE_STYLE);

AddSimpleReBarBand(hWndToolBar);

// 상태 바를 작성

CreateSimpleStatusBar();

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

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

{

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

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_MENUITEM_TOPMOST이라고 하는 자원ID을 설정합니다.



　CUpdateUI클래스는, 메인 윈도우인CMyWindow클래스의 base class로서 사용합니다. CMyWindow클래스에서는UI갱신 핸들러 맵을 준비해 갱신하는 메뉴 아이템의 자원ID과UI의 타입을 등록합니다. 덧붙여UI갱신 핸들러 맵은public나오지 않으면 안됩니다.

public:

// UI갱신 핸들러 맵

BEGIN_UPDATE_UI_MAP(CMyWindow)

UPDATE_ELEMENT(ID_MENUITEM_TOPMOST, UPDUI_MENUPOPUP)

END_UPDATE_UI_MAP()

이 예에서는 pop-up 타입의 메뉴 아이템을 등록하므로 ,UI의 타입을UPDUI_MENUPOPUP로 하고 있습니다. UI의 타입은 이것을 포함하고 다음과 같은 것이 준비되어 있습니다.

UI타입	설명
UPDUI_MENUPOPUP	pop-up menu(도구모음하의 메뉴 아이템 포함한다 )
UPDUI_MENUBAR	도구모음(톱 레벨의 메뉴 아이템)
UPDUI_CHILDWINDOW	자 윈도우
UPDUI_TOOLBAR	툴바
UPDUI_STATUSBAR	상태 바

　다음에 메세지 맵에 base class인CUpdateUI클래스에 체인을 추가합니다. 이것은 이번 예에서는 pop-up menu 아이템을 갱신하기 때문입니다. CUpdateUI클래스에 체인 하는 것에 의해 메인 윈도우에WM_INITMENUPOPUP메세지가 보내져 올 때마다 CUpdateUI클래스에 메세지가 보내집니다. CUpdateUI클래스의 base class이려면CUpdateUIBaseWM_INITMENUPOPUP메세지 핸들러가 준비되어 있어 그런데 pop-up menu 아이템 상태가 갱신됩니다.

　다음에 [항상 앞에 표시]메뉴 아이템이 선택되었을 때의 커멘드 메세지 핸들러를 추가합니다. 메세지 맵에ID가ID_MENUITEM_TOPMOST의 커멘드 메세지용의 엔트리를 추가해 OnMenuTopmost()라고 하는 메세지 핸들러를 호출하도록(듯이) 합니다. 이 핸들러에서는 ,UIGetState()에 의해 현재의 체크 상태를 취득해 CUpdateUI클래스의 멤버 함수인UISetCheck()으로 체크 마크의 부가와 소거를 바꾸고 있습니다.

여기서 주의하지 않으면 안 되는 것은 UISetCheck()을 호출한 직후에 pop-up menu 아이템의 체크 마크가 갱신되는 것이 아니라, 어디까지나 UISetCheck()를 호출한 후에WM_INITMENUPOPUP메세지가 보내져 오고 나서 , UI갱신 핸들러에 의해 자동적으로 갱신된다고 하는 것입니다.