ATL/WTL프로그래밍에서는 , 메세지와 그에 대한 핸들러 함수를 메세지 맵에 의해 연결시킵니다

ATL/WTL프로그래밍에서는 메세지와 그에 대한 핸들러 함수를 메세지 맵에 의해 연결시킵니다.

class CMyWindow : public CWindowImpl<CMyWindow>

{

// 메세지 맵

BEGIN_MSG_MAP(CMyWindow)

MESSAGE_HANDLER(WM_PAINT, OnPaint)

MESSAGE_HANDLER(WM_DESTROY, OnDestroy)

END_MSG_MAP()

LRESULT OnPaint(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled){

// WM_PAINT메세지에의 응답 처리

}

LRESULT OnDestroy(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled){

// WM_DESTROY메세지에의 응답 처리

}

};

　윈도우가 메세지를 받아들이면 메세지 맵의 선두로부터 순서에 검색되므로 빈번하게 사용되는 메세지를 최초에 기술해 두면 좋을 것입니다. 메세지 맵 중에 대응하는 메세지 매크로가 발견되지 않으면 메세지는 디폴트 윈도우 프로시저에게 건네집니다.

　ATL에서 준비하는 메세지 매크로는 크게 나누어 3종류 있습니다. 그것은 메세지 핸들러 매크로, 커멘드 핸들러 매크로 , 통지 핸들러 매크로의 3개입니다.

메세지 핸들러 매크로

　메세지 핸들러 매크로는 모든 메세지를 대상으로 합니다. 메세지 핸들러 매크로에는 다음의 2개가 있습니다.

MESSAGE_HANDLER(메세지명, 핸들러명)
지정된 메세지를 핸들러 함수에 맵 합니다.

MESSAGE_RANGE_HANDLER(개시 위치의 메세지명, 종료 위치의 메세지명, 핸들러명)
연속한 범위의 복수의 메세지를 핸들러에 맵 합니다.

메세지 핸들러 함수의 prototype를 이하에 나타냅니다.

LRESULT MessageHandler(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL& bHandled);

uMsg는 메세지를 식별해 wParam과 lParam은 메세지 파라미터입니다. 메세지 파라미터의 내용은 메세지의 종류에 의해 바뀝니다. bHandled은 메세지의 처리를 끝냈는지 어떠했는지를 나타내는 플래그입니다. bHandled하지만 핸들러 함수 중에서FALSE로 설정되어 있으면 메세지 맵의 나머지의 부분에서 그 메세지를 위한 핸들러가 별로 없는지 어떤지가 검색됩니다. bHandled은 핸들러 함수의 호출전에TRUE로 설정되므로 핸들러 함수가bHandled를 명시적으로FALSE로 설정하지 않는 한 그 이상의 핸들러 검색 처리는 행해지지 않습니다.

커멘드 핸들러 매크로

　커멘드 핸들러 매크로는 커멘드 메세지(WM_COMMAND) 를 대상으로 합니다. 커멘드 핸들러 매크로에는 다음의 4개가 있습니다.

COMMAND_HANDLER(ID, 통지 코드, 핸들러명)
지정된 컨트롤로부터의 지정된 통지 코드를 가지는 커멘드 메세지를 핸들러 함수에 맵 합니다.

COMMAND_ID_HANDLER(ID, 핸들러명)
지정된 컨트롤로부터의 임의의 통지 코드를 가지는 커멘드 메세지를 핸들러 함수에 맵 합니다.

COMMAND_CODE_HANDLER(통지 코드, 핸들러명)
임의의 컨트롤로부터의 지정된 통지 코드를 가지는 커멘드 메세지를 핸들러 함수에 맵 합니다.

COMMAND_RANGE_HANDLER(개시 위치의 메세지명, 종료 위치의 메세지명, 핸들러명)
연속한 범위의 컨트롤로부터의 커멘드 메세지를 핸들러 함수에 맵 합니다.

커멘드 핸들러 함수의 prototype를 이하에 나타냅니다.

LRESULT CommandHandler(WORD wNotifyCode, WORD wID, HWND hWndCtl, BOOL& bHandled);

wNotifyCode 는 통지 코드 wID는 커멘드를 송신하고 있는 컨트롤의 식별자 hWndCtl는 커멘드를 송신하고 있는 컨트롤의 핸들 bHandled은 전술의 플래그입니다.

통지 핸들러 매크로

　통지 핸들러 매크로는 통지 메세지(WM_NOTIFY) 를 대상으로 합니다. 통지 핸들러 매크로에는 다음의 4개가 있습니다.

NOTIFY_HANDLER(ID, 통지 코드, 핸들러명)
지정된 컨트롤로부터의 지정된 통지 코드를 가지는 통지 메세지를 핸들러 함수에 맵 합니다.

NOTIFY_ID_HANDLER(ID, 핸들러명)
지정된 컨트롤로부터의 임의의 통지 코드를 가지는 통지 메세지를 핸들러 함수에 맵 합니다.

NOTIFY_CODE_HANDLER(통지 코드, 핸들러명)
임의의 컨트롤로부터의 지정된 통지 코드를 가지는 통지 메세지를 핸들러 함수에 맵 합니다.

NOTIFY_RANGE_HANDLER(개시 위치의 메세지명, 종료 위치의 메세지명, 핸들러명)
연속한 범위의 컨트롤로부터의 통지 메세지를 핸들러 함수에 맵 합니다.

통지 핸들러 함수의 prototype를 이하에 나타냅니다.

LRESULT NotifyHandler(int idCtrl, LPNMHDR pnmh, BOOL& bHandled);

idCtrl은 통지를 송신하고 있는 컨트롤의 식별자 pnmh는 NMHDR구조체에의 포인터 bHandled는 전술의 플래그입니다.