< 메세지 리플렉션 >

통상 컨트롤은 WM_COMMAND(코먼 컨트롤의 경우는WM_NOTIFY) 메세지를 부모 윈도우에 송신합니다. 부모 윈도우는 그러한 메세지에 응답해 처리를 실행합니다.

　그러나 컨트롤이 보내는 그러한 메세지를 부모 윈도우는 아니고 그 컨트롤 자신에게 응답시키고 싶은 경우가 있습니다. 메세지 리플렉션은 이것을 실현하는 구조입니다. 메세지 리플렉션을 사용하면 컨트롤이 부모 윈도우에 보낸 메세지는 부모 윈도우로부터 컨트롤에 반송되어 컨트롤이 응답할 수가 있습니다.

다음에 나타내는 것은 컨트롤로부터의 메세지를 반송하는 부모 윈도우 클래스의 메세지 맵입니다.

// 부모 윈도우

class CMainDlg : public CDialogImpl<CMainDlg>

{

...

...

// 메세지 맵

BEGIN_MSG_MAP_EX(CMainDlg)

MSG_WM_INITDIALOG(OnInitDialog)

...

...

REFLECT_NOTIFICATIONS() // 처리되지 않았던 컨트롤로부터의 메세지를 반송

END_MSG_MAP()

...

...

　부모 윈도우(이 예에서는CMainDlg)는 컨트롤로부터의 메세지를 받아들이면 메세지 맵에 그 메시지 용의 메세지 맵 엔트리가 있는지 어떤지 조사합니다. 해당하는 메세지 맵 엔트리가 없으면 , REFLECT_NOTIFICATIONS 매크로에 의해 메세지를 보내 온 컨트롤에 반송합니다.

　다음에 반송된 메세지에 응답하는 컨트롤 클래스를 정의합니다. 여기에서는 버튼용 클래스CUrlButton를 정의합니다. CUrlButton클래스는 버튼의 캡션 캐릭터 라인을 URL이라고 가정해 버튼을 누르면 그 URL를 엽니다. 이 예에서는 UrlButton.h이라고 하는 헤더 파일을 준비해 거기에 CUrlButton클래스를 정의하고 있습니다.

// UrlButton.h

class CUrlButton : public CWindowImpl<CUrlButton>

{

public:

DECLARE_WND_SUPERCLASS(_T("UrlButton"), _T("BUTTON"))

// 메세지 맵

BEGIN_MSG_MAP_EX(CUrlButton)

MSG_OCM_COMMAND(OnCommand)

DEFAULT_REFLECTION_HANDLER()

END_MSG_MAP()

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

TCHAR szURL[2048];

GetWindowText(szURL, sizeof(szURL)/sizeof(TCHAR));

ShellExecute(m_hWnd, _T("open"), szURL, NULL, NULL, SW_SHOWNORMAL);

}

}

이것에 의해 부모 윈도우로부터 반송된 메세지는 메세지를 보낸 컨트롤의 메세지 맵으로 처리됩니다. 반송된 메시지는 OCM_으로 시작됩니다. (OCM_COMMAND나OCM_NOTIFY나OCM_CTLCOLORBTN등. ) WTL는 반송된 메세지를 위한 메세지 매크로를 준비해 있습니다. 위의 예에서는OCM_COMMAND 메시지를 MSG_OCM_COMMAND 메세지 매크로에 의해 OnCommand()에 매핑 하고 있습니다. 덧붙여 처리되지 않았던 메시지는 DEFAULT_REFLECTION_HANDLER 매크로에 의해 처리됩니다.

마지막으로 컨트롤을 작성할 필요가 있습니다. 작성하기 위해서는Create()을 호출합니다만 SubclassWindow()에 의해 기존의 컨트롤을 서브 클래스화할 수도 있습니다.

class CMainDlg : public CDialogImpl<CMainDlg>

{

...

...

enum { IDC_BUTTON_URL = 1001 };

CUrlButton m_button_url;

LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){

// 컨트롤 작성

m_button_url.Create(m_hWnd, CRect(0, 0, 200, 30),

_T("http://www.google.com/"), WS_CHILD | WS_VISIBLE, 0, IDC_BUTTON_URL);

// 또는 기존의 컨트롤을 서브 클래스화

// m_button_url.SubclassWindow(GetDlgItem(IDC_BUTTON_URL));

return TRUE;

}

...

...

이와 같이 메세지 리플렉션을 사용하면 컨트롤 클래스가 부모 윈도우에 의존하지 않고 자신이 부모 윈도우에 보낸 메세지에 대한 동작을 자기 자신으로 구현 할 수 있습니다.

　다음에 나타내는 것은 CUrlButton클래스를 사용하는 예입니다.

// stdafx.h

#include <atlbase.h>

#include <atlapp.h>

extern CAppModule _Module;

#include <atlwin.h>

#include <atlcrack.h>

#include <atlmisc.h>

// maindlg.h내

class CMainDlg : public CDialogImpl<CMainDlg>

{

public:

enum { IDD = IDD_MAINDLG };

CUrlButton m_button_url;

// 메세지 맵

BEGIN_MSG_MAP_EX(CMainDlg)

MSG_WM_INITDIALOG(OnInitDialog)

COMMAND_ID_HANDLER_EX(IDOK, OnOK)

COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)

REFLECT_NOTIFICATIONS() // 메세지를 반송

END_MSG_MAP()

LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){

// 스크린의 중앙에 배치

CenterWindow();

// 큰 아이콘 설정

HICON hIcon = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,

::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));

SetIcon(hIcon, TRUE);

// 작은 아이콘 설정

HICON hIconSmall = AtlLoadIconImage(IDR_MAINFRAME, LR_DEFAULTCOLOR,

::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));

SetIcon(hIconSmall, FALSE);

// 컨트롤 서브 클래스화

m_button_url.SubclassWindow(GetDlgItem(IDC_BUTTON_URL));

return TRUE;

}

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

EndDialog(nID);

}

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

EndDialog(nID);

}

};

// Control.cpp

#include "stdafx.h"

#include "resource.h"

#include "UrlButton.h"

#include "maindlg.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: 어플리케이션 실행

{

CMainDlg dlgMain;

nRet = dlgMain.DoModal();

}

_Module.Term();

::CoUninitialize();

return nRet;

}

　우선 리소스를 작성합니다. 다이얼로그에 버튼 컨트롤을 배치하고 리소수 ID를 다음과 같이 지정합니다. 덧붙여 버튼의 캡션은 유효한URL캐릭터 라인으로 설정합니다.

컨트롤명	리소스 ID
푸쉬 버튼	IDC_BUTTON_URL

　다음에 CMainDlg 클래스에서 URL버튼용으로 CUrlButton 클래스의 인스턴스를 멤버 변수로서 선언합니다.

　다음에 메세지 맵으로 REFLECT_NOTIFICATIONS를 추가해 마지막에 WM_INITDIALOG 메세지 핸들러로 SubclassWindow()에 의해 기존의 버튼 컨트롤을 서브 클래스화합니다.

　그런데 이번은 반송된 메세지의 매핑에 MSG_OCM_COMMAND 메세지 매크로를 사용했습니다만 WTL은 반송된 메시지용 으로 다음과 같은 종류의 메세지 매크로를 준비해 있습니다.

메세지 리플렉션용 커멘드 핸들러 매크로

다음의 메세지 매크로는 , 반송된 커멘드 메세지(OCM_COMMAND) 을 대상으로 합니다. MSG_OCM_COMMAND(핸들러명) 반송된 커멘드 메세지를 핸들러 함수에 맵 합니다. REFLECTED_COMMAND_HANDLER_EX(ID, 통지 코드, 핸들러명) 지정된 컨트롤로부터의 지정된 통지 코드를 가지는 반송된 커멘드 메세지를 핸들러 함수에 맵 합니다. REFLECTED_COMMAND_ID_HANDLER_EX(ID, 핸들러명) 지정된 컨트롤로부터의 임의의 통지 코드를 가지는 반송된 커멘드 메세지를 핸들러 함수에 맵 합니다. REFLECTED_COMMAND_CODE_HANDLER_EX(통지 코드, 핸들러명) 임의의 컨트롤로부터의 지정된 통지 코드를 가지는 반송된 커멘드 메세지를 핸들러 함수에 맵 합니다. REFLECTED_COMMAND_RANGE_HANDLER_EX(개시 위치의 메세지명, 종료 위치의 메세지명, 핸들러명) 연속한 범위의 컨트롤로부터의 반송된 커멘드 메세지를 핸들러 함수에 맵 합니다. REFLECTED_COMMAND_RANGE_CODE_HANDLER_EX(개시 위치의 메세지명, 종료 위치의 메세지명, 통지 코드, 핸들러명) 연속한 범위의 컨트롤로부터의 지정된 통지 코드를 가지는 반송된 커멘드 메세지를 핸들러 함수에 맵 합니다.

메세지 리플렉션용 통지 핸들러 매크로

다음의 메세지 매크로는 , 반송된 통지 메세지(OCM_NOTIFY) 를 대상으로 합니다. MSG_OCM_NOTIFY(핸들러명) 반송된 통지 메세지를 핸들러 함수에 맵 합니다. REFLECTED_NOTIFY_HANDLER_EX(ID, 통지 코드, 핸들러명) 지정된 컨트롤로부터의 지정된 통지 코드를 가지는 반송된 통지 메세지를 핸들러 함수에 맵 합니다. REFLECTED_NOTIFY_ID_HANDLER_EX(ID, 핸들러명) 지정된 컨트롤로부터의 임의의 통지 코드를 가지는 반송된 통지 메세지를 핸들러 함수에 맵 합니다. REFLECTED_NOTIFY_CODE_HANDLER_EX(통지 코드, 핸들러명) 임의의 컨트롤로부터의 지정된 통지 코드를 가지는 반송된 통지 메세지를 핸들러 함수에 맵 합니다. REFLECTED_NOTIFY_RANGE_HANDLER_EX(개시 위치의 메세지명, 종료 위치의 메세지명, 핸들러명) 연속한 범위의 컨트롤로부터의 반송된 통지 메세지를 핸들러 함수에 맵 합니다. REFLECTED_NOTIFY_RANGE_CODE_HANDLER_EX(개시 위치의 메세지명, 종료 위치의 메세지명, 통지 코드, 핸들러명) 연속한 범위의 컨트롤로부터의 지정된 통지 코드를 가지는 반송된 통지 메세지를 핸들러 함수에 맵 합니다.

그 외의 메세지 리플렉션용 핸들러 매크로

다음의 메세지 매크로는 , 앞에서 말한 것 이외의 메세지 리플렉션용 메세지를 대상으로 합니다. MSG_OCM_PARENTNOTIFY(핸들러명) MSG_OCM_DRAWITEM(핸들러명) MSG_OCM_MEASUREITEM(핸들러명) MSG_OCM_COMPAREITEM(핸들러명) MSG_OCM_DELETEITEM(핸들러명) MSG_OCM_VKEYTOITEM(핸들러명) MSG_OCM_CHARTOITEM(핸들러명) MSG_OCM_HSCROLL(핸들러명) MSG_OCM_VSCROLL(핸들러명) MSG_OCM_CTLCOLOREDIT(핸들러명) MSG_OCM_CTLCOLORLISTBOX(핸들러명) MSG_OCM_CTLCOLORBTN(핸들러명) MSG_OCM_CTLCOLORDLG(핸들러명) MSG_OCM_CTLCOLORSCROLLBAR(핸들러명) MSG_OCM_CTLCOLORSTATIC(핸들러명)