MFC PreTranslateMessage 함수 완전 정복

🔗 PreTranslateMessage란 무엇인가요?

MFC에서 PreTranslateMessage는 CWnd 클래스에서 제공되는 가상 함수입니다.
이 함수는 윈도우 메시지가 본격적으로 디스패치되기 전에 먼저 호출되어, 메시지를 가로채거나 조작할 수 있는 기회를 제공합니다.
다시 말해, 이 함수는 메시지를 최종 윈도우에 전달하기 전에 전처리(Pre-Processing) 작업을 할 수 있도록 해주는 훅(Hook) 역할을 합니다.

특히 이 함수는 키보드 입력 이벤트에서 주로 활용되며, 단축키, 탭 이동, 엔터 키 처리 등의 특수 키 입력을 제어하는 데 매우 유용합니다.
예를 들어, 다이얼로그 박스 안에서 탭(Tab) 키로 포커스를 이동하거나, 특정 키 입력 시 사용자 정의 기능을 실행하고 싶을 때 이 함수를 오버라이드합니다.

이 함수는 보통 다음과 같이 선언되며, 전달되는 MSG* pMsg 파라미터를 통해 메시지의 종류와 세부 정보를 파악할 수 있습니다.

virtual BOOL PreTranslateMessage(MSG* pMsg);

이 함수가 TRUE를 반환하면 메시지가 처리된 것으로 간주되어 더 이상 전파되지 않으며, FALSE를 반환하면 메시지가 일반적인 흐름대로 전달됩니다.
이 특성 덕분에 개발자는 필요한 메시지만 선별적으로 처리할 수 있게 됩니다.

🛠️ 메시지 루프와 호출 시점

PreTranslateMessage() 함수는 MFC 메시지 루프 내부에서 호출됩니다.
MFC 애플리케이션의 메인 루프는 메시지를 수신하고 처리하는 핵심 흐름을 담당하며, 이 루프 안에서 메시지가 최종적으로 디스패치되기 전에 각 윈도우 클래스에게 이 함수를 호출할 기회를 줍니다.

다음은 일반적인 메시지 루프 구조이며, 이 안에서 PreTranslateMessage가 호출되는 위치를 볼 수 있습니다.

while (GetMessage(&msg, nullptr, 0, 0))
{
    if (!pMainWnd->PreTranslateMessage(&msg))
    {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
}

위 코드에서 알 수 있듯이 PreTranslateMessage()는 메시지를 번역하거나 전달하기 전, 즉 TranslateMessage()나 DispatchMessage()보다 먼저 호출됩니다.
이 구조 덕분에 사용자는 메시지를 디스패치 전에 가로채서 필요에 따라 필터링하거나 별도로 처리할 수 있는 것이죠.

💬 PreTranslateMessage는 오직 MFC 프레임워크에서만 호출되며, 순수 Win32 API에서는 사용되지 않습니다.

만약 이 함수가 제대로 동작하지 않거나 호출되지 않는다면, 해당 클래스가 CWnd를 상속하고 있는지, 그리고 PreTranslateMessage()를 오버라이드했는지 반드시 확인해야 합니다.
또한 CWinApp이나 CDialog와 같은 주요 클래스에서도 호출 구조를 잘 이해하고 있어야 올바른 위치에서 이벤트를 처리할 수 있습니다.

⚙️ 오버라이드 방법과 구현 구조

PreTranslateMessage()를 활용하려면 먼저 오버라이드를 통해 원하는 동작을 정의해야 합니다.
이 함수는 MFC의 거의 모든 윈도우 클래스(CWnd 계열)에서 오버라이드가 가능하며, 가장 흔히 사용하는 예는 CDialog, CView, CFrameWnd 등입니다.

오버라이드 시에는 MSG 구조체의 내용을 분석하여 어떤 메시지인지 판단하고, 조건에 맞는 처리를 수행하면 됩니다.
기본 구현을 유지하면서 특정 키 이벤트만 처리하고 싶다면 CWnd::PreTranslateMessage를 호출하여 기본 동작을 유지할 수도 있습니다.

BOOL CMyDialog::PreTranslateMessage(MSG* pMsg)
{
    if (pMsg->message == WM_KEYDOWN && pMsg->wParam == VK_RETURN)
    {
        AfxMessageBox(_T("Enter 키가 눌렸습니다!"));
        return TRUE; // 메시지 처리 완료
    }

    return CDialogEx::PreTranslateMessage(pMsg); // 기본 처리 유지
}

위 예제는 Enter 키가 눌렸을 때 메시지를 가로채 사용자 정의 동작을 수행하고, 그 외에는 기본 처리를 그대로 유지하는 구조입니다.
VK_TAB, VK_ESCAPE 등 다양한 키코드와 조합하여 여러 기능을 구현할 수 있습니다.

• ✍️클래스가 CWnd 기반인지 확인
• 🔎pMsg 구조체의 message, wParam 조합 확인
• 💡return TRUE 시 메시지 소멸, FALSE 시 계속 처리됨

오버라이드한 함수 안에서는 모든 메시지를 다룰 수 있으므로 너무 많은 조건을 처리하면 성능 저하가 발생할 수 있어, 반드시 필요한 조건만 선별하여 사용하는 것이 좋습니다.

🔌 단축키 및 특수 키 처리 예제

PreTranslateMessage()는 단순한 메시지 필터링을 넘어서, 단축키 기능 구현이나 사용자 정의 키 이벤트 처리에 매우 유용합니다.
MFC에서 이런 기능을 구성하려면 메시지를 직접 가로채고 적절한 조건에서 원하는 동작을 호출해야 하며, 이 모든 작업이 이 함수 안에서 가능하죠.

🖱️ Ctrl + S 단축키 구현 예제

아래 코드는 Ctrl + S를 눌렀을 때 저장 기능을 수행하는 예제입니다.
단축키는 일반 메시지 루프에서는 감지되지 않지만, PreTranslateMessage()를 사용하면 직접 확인하고 원하는 동작을 수행할 수 있습니다.

BOOL CMyDialog::PreTranslateMessage(MSG* pMsg)
{
    if (pMsg->message == WM_KEYDOWN)
    {
        if (GetKeyState(VK_CONTROL) & 0x8000 && pMsg->wParam == 'S')
        {
            AfxMessageBox(_T("저장되었습니다."));
            return TRUE;
        }
    }

    return CDialogEx::PreTranslateMessage(pMsg);
}

⏎ Enter 키를 Tab처럼 동작시키기

입력 폼이나 다이얼로그에서 Enter 키를 누르면 Tab 키처럼 다음 컨트롤로 포커스를 이동시키고 싶은 경우도 많습니다.
아래는 그런 처리를 위한 예제입니다.

if (pMsg->message == WM_KEYDOWN && pMsg->wParam == VK_RETURN)
{
    ::SendMessage(pMsg->hwnd, WM_KEYDOWN, VK_TAB, 0);
    return TRUE;
}

이처럼 PreTranslateMessage를 활용하면 기본적으로 제공되지 않는 유연한 키 이벤트 처리가 가능하며, 사용자 중심의 인터페이스를 구축할 수 있습니다.

💡 오작동 방지를 위한 주의사항

PreTranslateMessage()는 매우 강력한 함수이지만, 잘못 사용하면 의도하지 않은 동작을 유발하거나 다른 기능과 충돌할 수 있습니다.
특히 모든 메시지를 감시할 수 있다는 특성 때문에 필터링 조건이 부족하거나 무분별하게 키 처리를 수행할 경우, 사용자의 입력 흐름을 방해하게 됩니다.

또한 MFC 프레임워크는 PreTranslateMessage() 외에도 OnKeyDown, OnCommand 같은 다른 이벤트 처리 메커니즘을 제공하므로, 우선순위와 책임 범위를 명확히 나누어 구현하는 것이 중요합니다.

• ⚠️불필요한 메시지까지 TRUE로 처리하지 않도록 주의
• 🧪디버깅 시 로그 출력을 통해 어떤 메시지가 들어오는지 파악
• 🧩기본 메시지 흐름을 방해하지 않도록 return FALSE 활용
• 📌UI/UX 요소에 따라 키 처리 동작을 구분할 것

정리하자면, PreTranslateMessage()는 유용하면서도 민감한 기능입니다.
기능을 구현할 때는 항상 사용자 경험을 고려하고, 불필요한 메시지 개입을 최소화하는 방향으로 코드를 설계해야 안정적인 애플리케이션을 만들 수 있습니다.

❓ 자주 묻는 질문 (FAQ)