MFC 메시지 맵(Message Map) 완전 정복: ON_BN_CLICKED와 WM_PAINT 처리법

🔗 메시지 맵(Message Map)이란?

MFC(Message Foundation Class)의 가장 핵심적인 기능 중 하나는 메시지 기반 이벤트 처리 시스템입니다.
윈도우 프로그래밍에서는 마우스 클릭, 키보드 입력, 창 크기 조절 등 다양한 이벤트가 발생하는데,
이런 이벤트를 적절한 함수와 연결시켜주는 역할을 하는 것이 바로 메시지 맵(Message Map)입니다.

MFC는 C++ 클래스에 특정 메시지가 발생했을 때 어떤 함수로 연결할지 정의하는 매크로 시스템을 제공합니다.
이 방식은 매우 간결하고 효율적이며, 복잡한 이벤트 처리를 명확하게 정리할 수 있다는 점에서 큰 장점이 있습니다.
즉, 메시지 맵은 “특정 메시지가 발생하면, 이 함수를 호출하라”는 일종의 연결 고리 역할을 해주는 구조입니다.

• 📩이벤트 메시지: WM_PAINT, WM_LBUTTONDOWN 등 다양한 시스템 메시지
• 🔗핸들러 연결: 메시지를 처리할 사용자 정의 함수로 연결
• 🧩매크로 사용: BEGIN_MESSAGE_MAP, ON_COMMAND, ON_WM_PAINT 등

예를 들어, 버튼 클릭 이벤트가 발생했을 때 해당 버튼의 ID와 관련된 ON_BN_CLICKED 매크로를 통해,
정해진 멤버 함수가 호출되도록 구성할 수 있습니다.
이는 C 언어 시절의 콜백 함수 등록 방식보다 훨씬 직관적이고 구조적입니다.

💬 MFC의 메시지 맵은 복잡한 윈도우 이벤트 처리 과정을 C++ 클래스 구조 안에 효율적으로 통합시켜주는 시스템입니다.

🛠️ MFC 메시지 처리 방식의 구조

MFC는 내부적으로 윈도우 메시지를 C++ 클래스와 연결하는 구조를 가지고 있습니다.
기본적으로 메시지는 윈도우 운영체제에서 생성되며, MFC 애플리케이션은 이 메시지를 받아 적절한 클래스 멤버 함수로 전달하는 방식으로 동작하죠.
이때 필요한 것이 메시지 루프(message loop)와 메시지 맵(message map)입니다.

메시지는 먼저 운영체제에 의해 생성되어 GetMessage() 함수로 받아들여지며,
그 다음 TranslateMessage() → DispatchMessage() 순으로 처리됩니다.
그리고 MFC 프레임워크는 메시지를 클래스의 핸들러 함수로 매핑하기 위해 메시지 맵 테이블을 활용하게 됩니다.

• 🔁OS에서 발생한 메시지는 먼저 애플리케이션의 메시지 루프를 거칩니다
• 🧭MFC 클래스의 메시지 맵이 해당 메시지를 적절한 함수로 전달합니다
• 📥핸들러 함수에서 메시지를 처리한 뒤 UI 또는 로직에 반영합니다

이런 구조 덕분에 개발자는 메시지 처리 과정을 복잡하게 신경 쓰지 않고,
각 메시지에 대응하는 함수만 구현하면 되기 때문에 생산성과 유지보수성이 크게 향상됩니다.

⚙️ ON_WM_PAINT 매크로 사용법

윈도우 창에 그래픽이나 텍스트를 그려야 할 때 호출되는 메시지가 WM_PAINT입니다.
MFC에서는 이 메시지를 처리하기 위해 ON_WM_PAINT 매크로를 메시지 맵에 등록하고,
해당 클래스 내에서 OnPaint() 함수를 구현해야 합니다.

이는 사용자 정의 그리기 처리를 할 수 있도록 도와주며,
특정 상황(예: 창 크기 변경, 숨김 해제 등)에서 자동으로 호출되어 화면 갱신을 담당하게 됩니다.

// 메시지 맵에 등록
BEGIN_MESSAGE_MAP(CMyView, CView)
    ON_WM_PAINT()
END_MESSAGE_MAP()

// 핸들러 함수 정의
void CMyView::OnPaint()
{
    CPaintDC dc(this); // 디바이스 컨텍스트 얻기
    dc.TextOutW(10, 10, L"Hello, MFC!");
}

위의 예시처럼 메시지 맵에 ON_WM_PAINT()를 등록하면,
윈도우가 WM_PAINT 메시지를 보내는 시점에 OnPaint() 함수가 자동 호출됩니다.
그 안에서 CPaintDC를 사용해 원하는 그리기 작업을 수행할 수 있어요.

• 🖼️화면에 텍스트, 도형 등을 그릴 때는 WM_PAINT를 활용
• 🔧CPaintDC는 그리기 작업을 위한 디바이스 컨텍스트 객체
• 💡OnPaint는 사용자가 직접 호출하면 안 되고, 시스템이 자동 호출함

🔌 ON_BN_CLICKED 버튼 이벤트 처리

사용자 인터페이스에서 가장 자주 사용되는 컨트롤 중 하나는 버튼(Button)입니다.
이 버튼을 클릭했을 때 원하는 동작을 수행하도록 연결해주는 것이 바로 ON_BN_CLICKED 매크로입니다.

MFC에서는 각 버튼에 ID를 부여하고,
그 ID를 기준으로 클릭 이벤트가 발생할 경우 어떤 함수를 호출할지 메시지 맵에 등록합니다.
매우 직관적이고 확장성 있는 구조죠.

// 메시지 맵 등록
BEGIN_MESSAGE_MAP(CMyDialog, CDialogEx)
    ON_BN_CLICKED(IDC_MYBUTTON, &CMyDialog::OnMyButtonClick)
END_MESSAGE_MAP()

// 핸들러 함수 정의
void CMyDialog::OnMyButtonClick()
{
    AfxMessageBox(_T("버튼이 클릭되었습니다!"));
}

이처럼 ON_BN_CLICKED 매크로는 버튼 ID와 멤버 함수를 매핑하는 역할을 하며,
핸들러 함수 내부에서는 다이얼로그 닫기, 텍스트 변경, 다른 윈도우 열기 등 다양한 작업을 수행할 수 있습니다.

• 🖱️ON_BN_CLICKED는 버튼 클릭 이벤트 전용 매크로입니다
• 📌버튼의 ID와 멤버 함수를 정확히 매핑해야 동작합니다
• 🔐핸들러 함수는 void 반환형이며, 클래스 내에서 정의해야 합니다

💡 BEGIN_MESSAGE_MAP 매크로와 구조

MFC의 메시지 맵 시스템은 BEGIN_MESSAGE_MAP과 END_MESSAGE_MAP 사이에 위치한 매크로 정의들을 기반으로 작동합니다.
이 영역은 클래스와 메시지를 연결해주는 매핑 테이블의 역할을 하며, 모든 메시지 핸들러는 이 블록 내부에 선언되어야 합니다.

MFC는 이 메시지 맵 테이블을 런타임에 검색하여,
어떤 메시지가 발생했을 때 어떤 함수가 실행되어야 할지를 결정합니다.
이 방식은 객체지향적 구조와 완벽하게 결합되어 있어, 클래스 기반으로 깔끔한 이벤트 처리를 가능하게 해줍니다.

// 메시지 맵 구조 예시
BEGIN_MESSAGE_MAP(CMyDialog, CDialogEx)
    ON_WM_PAINT()
    ON_BN_CLICKED(IDC_MYBUTTON, &CMyDialog::OnMyButtonClick)
END_MESSAGE_MAP()

이 구조를 통해 하나의 클래스에서 여러 메시지를 처리할 수 있으며,
윈도우 클래스마다 자신만의 메시지 맵을 가질 수 있습니다.
또한, 클래스 계층 구조에 따라 부모 클래스의 메시지 맵도 자동으로 연결되기 때문에 확장성과 재사용성이 매우 뛰어납니다.

• 📌BEGIN_MESSAGE_MAP은 클래스명과 부모 클래스를 지정해야 합니다
• 🧱ON_ 매크로들은 BEGIN과 END 사이에 위치해야 인식됩니다
• 🔁하위 클래스는 상위 클래스의 메시지 맵을 자동으로 상속받습니다

❓ 자주 묻는 질문 (FAQ)