C++Builder 註冊全域熱鍵實現最小化到托盤/顯示切換

核心 API：RegisterHotKey / UnregisterHotKey

BOOL RegisterHotKey(
    HWND hWnd,      // 接收 WM_HOTKEY 的視窗
    int id,         // 熱鍵 ID (應用程式內唯一)
    UINT fsModifiers, // 修飾鍵組合
    UINT vk         // 虛擬鍵碼
);

修飾鍵常數

完整實作代碼

標頭檔 (Unit1.h)

class TMainForm : public TForm
{
__published:
    // IDE 管理元件...
private:
    // 1. 訊息處理函數宣告
    void __fastcall OnHotKey(TMessage &Message);
protected:
    // 2. 訊息映射表
    BEGIN_MESSAGE_MAP
        MESSAGE_HANDLER(WM_HOTKEY, TMessage, OnHotKey)
    END_MESSAGE_MAP(TForm)
public:
    __fastcall TMainForm(TComponent* Owner);
    __fastcall ~TMainForm();
};

實作檔 (Unit1.cpp)

__fastcall TMainForm::TMainForm(TComponent* Owner) : TForm(Owner)
{
    // 建構子中註冊熱鍵：Ctrl + F12
    if (!RegisterHotKey(Handle, 2000, MOD_CONTROL, VK_F12)) {
        ShowMessage("熱鍵註冊失敗，可能已被其他程式佔用");
    }
}

__fastcall TMainForm::~TMainForm()
{
    // 解構子註銷熱鍵
    UnregisterHotKey(Handle, 2000);
}

void __fastcall TMainForm::OnHotKey(TMessage &Message)
{
    // Message.WParam = 熱鍵 ID (2000)
    // Message.LParam 低字 = 修飾鍵, 高字 = 虛擬鍵碼
    if (Message.WParam == 2000) {
        // 切換視窗顯示/隱藏
        if (!Visible) {
            Show();
            BringToFront(); // 置頂並激活
        } else {
            Hide();
        }
    }
    // 必須傳遞給基類處理其他可能的熱鍵
    TForm::Dispatch(&Message);
}

進階應用模式

多組熱鍵管理

enum HotKeyIDs {
    HKID_TOGGLE_VISIBILITY = 1000,
    HKID_SHOW_SETTINGS     = 1001,
    HKID_QUICK_CAPTURE     = 1002
};

__fastcall TMainForm::TMainForm(TComponent* Owner) : TForm(Owner)
{
    RegisterHotKey(Handle, HKID_TOGGLE_VISIBILITY, MOD_CONTROL | MOD_SHIFT, 'H');
    RegisterHotKey(Handle, HKID_SHOW_SETTINGS,     MOD_CONTROL | MOD_ALT,   'S');
    RegisterHotKey(Handle, HKID_QUICK_CAPTURE,     MOD_WIN,                 VK_SNAPSHOT);
}

void __fastcall TMainForm::OnHotKey(TMessage &Message)
{
    switch (Message.WParam) {
        case HKID_TOGGLE_VISIBILITY: ToggleVisibility(); break;
        case HKID_SHOW_SETTINGS:     ShowSettings(); break;
        case HKID_QUICK_CAPTURE:     DoScreenCapture(); break;
    }
    TForm::Dispatch(&Message);
}

熱鍵衝突處理

• RegisterHotKey 失敗返回 FALSE，GetLastError() 可能為 ERROR_HOTKEY_ALREADY_REGISTERED (1409)。
• 策略：嘗試替代組合、提示使用者自訂、或使用 RegisterWindowMessage 配合鉤子實現更靈活的全域熱鍵。

常見問題排查

替代方案對比

RegisterHotKey 是實現應用級全域熱鍵最輕量、最標準的方式，配合 WM_HOTKEY 訊息映射，幾行代碼即可賦予程式「隱身喚醒」能力。