C++ Builder 非可視組件的消息處理技巧：建立隱藏視窗接收 Windows 訊息

在 C++ Builder 開發中，非可視組件（Non-visual Component）常因缺乏視窗控制代碼而無法直接接收 Windows 訊息。這篇文章詳細說明如何透過建立隱藏視窗，讓非可視組件具備訊息處理能力，並附上完整的實作範例程式碼。

核心概念：為何需要隱藏視窗？

Windows 訊息機制要求接收端必須擁有視窗控制代碼。非可視組件繼承自 TComponent，本身不擁有視窗，自然也就沒有 HWND，無法直接參與訊息循環。解決方案是呼叫 VCL 提供的 AllocateHWnd 函數，在背景建立一個隱藏視窗，並指定自訂的視窗程序（WndProc）來處理訊息。

實作步驟完整解析

1. 宣告必要的成員變數與函數

在組件的標頭檔（.h）私有區塊加入：

private:
    HWND FHandle;
    void __fastcall WndProc(TMessage &Msg);

FHandle 用於儲存 AllocateHWnd 傳回的視窗控制代碼；WndProc 則是處理訊息的核心函數，必須採用 __fastcall 慣例並接受 TMessage 參考。

2. 定義自訂訊息常數

在實作檔（.cpp）頂端定義使用者訊息，避免與系統訊息衝突：

#define MY_MESSAGE (WM_USER + 1)

3. 建構函數中建立隱藏視窗

__fastcall TTest::TTest(TComponent* Owner)
    : TComponent(Owner)
{
    FHandle = AllocateHWnd(WndProc);
}

AllocateHWnd 會建立一個不顯示的視窗，並將 WndProc 設為該視窗的訊息處理函數，傳回的 HWND 存入 FHandle。

4. 實作 WndProc 訊息分派器

void __fastcall TTest::WndProc(TMessage &Msg)
{
    if (Msg.Msg == MY_MESSAGE) {
        MessageBox(0, L"Got here!", L"Message", 0);
    }
    try {
        Dispatch(&Msg);  // 讓 VCL 繼續處理其他訊息
    } catch (...) {
        Application->HandleException(this);
    }
}

此函數攔截自訂訊息 MY_MESSAGE 並彈出對話方塊示範，其他訊息透過 Dispatch 交給 VCL 預設處理流程，try/catch 確保例外安全。

5. 提供公開方法觸發訊息

void __fastcall TTest::DoIt()
{
    PostMessage(FHandle, MY_MESSAGE, 0, 0);
}

外部程式呼叫 DoIt() 即可向組件的隱藏視窗發送訊息，觸發 WndProc 中的處理邏輯。

安裝與測試組件

1. 將組件專案加入套件專案（.bpk），編譯安裝至 IDE 元件調色盤。
2. 在測試表單放入一個按鈕，OnClick 事件撰寫 Test1->DoIt();。
3. 執行專案，點擊按鈕即會彈出 "Got here!" 訊息方塊，證明訊息機制運作正常。

應用場景與總結

此技巧廣泛應用於封裝需接收非同步通知的 Windows API，例如 TAPI 電話服務、WinSock 網路事件等。透過隱藏視窗，非可視組件即可像視窗化控制項一樣參與 Windows 訊息循環，大幅擴展組件的應用範圍。本範例於 C++ Builder 3.0 環境測試通過，同樣適用於更新版本。