C++Builder 捕獲 VCL 未處理的 Windows 訊息：訊息映射表實戰教學

為什麼需要捕獲未處理訊息？

VCL 封裝了常用訊息（Click、Paint、KeyDown 等），但大量 Windows 訊息（WM_NCHITTEST, WM_DEVICECHANGE, WM_POWERBROADCAST 等）未暴露為事件。訊息映射表（BEGIN_MESSAGE_MAP）是填補這些缺口的標準機制。

訊息映射表語法詳解

BEGIN_MESSAGE_MAP
    MESSAGE_HANDLER(, , )
    ...
END_MESSAGE_MAP()

• Message：Windows 訊息常數（WM_NCHITTEST 等）。
• MessageStruct：參數結構，基本型為 TMessage（含 Msg, WParam, LParam, Result）。
• Handler：處理函數名，簽名 void __fastcall Handler(TMessage &Msg)。
• BaseClass：父類別名，未命中時呼叫 BaseClass::Dispatch。

實戰案例：無標題視窗拖動

需求：移除標題列，但保留拖動移動視窗功能。

步驟 1：移除標題列（CreateParams）

// 標頭檔
protected:
    virtual void __fastcall CreateParams(TCreateParams &Params);

// 實作檔
void __fastcall TForm1::CreateParams(TCreateParams &Params)
{
    TForm::CreateParams(Params);
    Params.Style &= ~WS_CAPTION; // 關鍵：移除 WS_CAPTION 風格
}

步驟 2：建立訊息映射表捕獲 WM_NCHITTEST

// 標頭檔 private 區
void __fastcall WMNCHitTest(TMessage &Message);

// protected 區
BEGIN_MESSAGE_MAP
    MESSAGE_HANDLER(WM_NCHITTEST, TMessage, WMNCHitTest)
END_MESSAGE_MAP(TForm)

步驟 3：實作命中測試邏輯

void __fastcall TForm1::WMNCHitTest(TMessage &Message)
{
    // 僅在左鍵按下時偽裝為標題列
    if (GetAsyncKeyState(VK_LBUTTON) < 0) {
        Message.Result = HTCAPTION; // 告訴系統：滑鼠在標題列上
    } else {
        Message.Result = HTCLIENT;  // 否則：在客戶區
    }
}

關鍵 API 深度解析

擴展：更完善的無標題視窗

void __fastcall TForm1::WMNCHitTest(TMessage &Message)
{
    TPoint pt = { LOWORD(Message.LParam), HIWORD(Message.LParam) };
    pt = ScreenToClient(pt);

    // 1. 右下角縮放區 (16x16)
    if (pt.x >= ClientWidth - 16 && pt.y >= ClientHeight - 16) {
        Message.Result = HTBOTTOMRIGHT; return;
    }
    // 2. 底邊/右邊縮放
    if (pt.y >= ClientHeight - 4) { Message.Result = HTBOTTOM; return; }
    if (pt.x >= ClientWidth - 4)  { Message.Result = HTRIGHT; return; }
    // 3. 標題列區域 (頂部 30px)
    if (pt.y < 30) {
        if (GetAsyncKeyState(VK_LBUTTON) < 0)
            Message.Result = HTCAPTION;
        else
            Message.Result = HTCLIENT;
        return;
    }
    // 4. 其他客戶區
    Message.Result = HTCLIENT;
}

適用訊息速查表

調試技巧

• 使用 OutputDebugString 印出 Message.Msg 確認訊息到達。
• Spy++ (Visual Studio 工具) 監控視窗訊息流。
• 在 Handler 設置斷點，檢查 WParam/LParam/Result。

訊息映射表是 VCL 開發者通往 Windows 核心訊息層的標準通道，掌握它即掌握了視窗行為的終極控制權。