C++Builder 系統托盤程式開發：Shell_NotifyIcon 完整指南

什麼是系統托盤？

任務列右側通知區域。應用程式放置圖示提供狀態指示、快速存取選單、雙擊還原主視窗等功能。核心 API：**Shell_NotifyIcon**。

NOTIFYICONDATA 結構體關鍵欄位

三大核心操作

// 1. 新增圖示
bool AddTrayIcon(HWND hwnd, UINT id, HICON hIcon, UINT msg, LPCTSTR tip) {
    NOTIFYICONDATA nid = { sizeof(nid) };
    nid.hWnd = hwnd; nid.uID = id; nid.uFlags = NIF_MESSAGE|NIF_ICON|NIF_TIP;
    nid.uCallbackMessage = msg; nid.hIcon = hIcon;
    lstrcpyn(nid.szTip, tip, 128);
    return Shell_NotifyIcon(NIM_ADD, &nid);
}

// 2. 修改圖示/提示
bool ModifyTrayIcon(HWND hwnd, UINT id, HICON hIcon, LPCTSTR tip) {
    NOTIFYICONDATA nid = { sizeof(nid) };
    nid.hWnd = hwnd; nid.uID = id; nid.uFlags = NIF_ICON|NIF_TIP;
    nid.hIcon = hIcon; lstrcpyn(nid.szTip, tip, 128);
    return Shell_NotifyIcon(NIM_MODIFY, &nid);
}

// 3. 移除圖示
bool RemoveTrayIcon(HWND hwnd, UINT id) {
    NOTIFYICONDATA nid = { sizeof(nid) };
    nid.hWnd = hwnd; nid.uID = id;
    return Shell_NotifyIcon(NIM_DELETE, &nid);
}

處理滑鼠事件：自訂訊息回呼

// 表單頭檔宣告
#define WM_TRAYICON (WM_APP + 100)
BEGIN_MESSAGE_MAP
    VCL_MESSAGE_HANDLER(WM_TRAYICON, TMessage, OnTrayIcon)
END_MESSAGE_MAP(TForm)

// 處理函式
void __fastcall TForm1::OnTrayIcon(TMessage& Msg) {
    switch (Msg.LParam) {
        case WM_LBUTTONDBLCLK:  // 雙擊左鍵
            ShowWindow(Handle, SW_SHOW);
            Application->Restore();
            break;
        case WM_RBUTTONUP: {    // 右鍵彈出選單
            POINT pt; GetCursorPos(&pt);
            SetForegroundWindow(Handle);  // 修正選單焦點問題
            PopupMenu1->Popup(pt.x, pt.y);
            break;
        }
    }
}

C++Builder 專用簡化：TrayIcon 元件

元件面板 **Additional** 頁面有 TTrayIcon，屬性設定：

• Icons：圖示集合（動畫支援）。
• Hint：工具提示。
• Animate/AnimateInterval：動畫控制。
• OnClick/OnDblClick/OnMouseDown：事件直接處理。
• PopupMenu：關聯右鍵選單。

**推薦新專案直接使用 TTrayIcon**，封裝了 Shell_NotifyIcon 細節、自動處理視窗建立/銷毀時機、支援設計時預覽。

常見坑與解決

總結

系統托盤開發核心是 **NOTIFYICONDATA 正確初始化 + Shell_NotifyIcon 三大操作 + 自訂訊息處理滑鼠事件**。C++Builder 開發者**強烈建議使用 TTrayIcon 元件**，專注業務邏輯而非 API 細節。記住處理 WM_TASKBARCREATED 確保 Explorer 重啟後圖示自動恢復。

1. 上一篇文章： C++Builder 系統選單擴展：新增選單項與事件響應
2. 下一篇文章： C++Builder 註冊表操作完全指南：TRegistry 類別實戰

VC 教學

VC++ 自繪顏色下拉方塊：ComboBox 實作色盤選擇器

前言 Word 的字型顏色下拉選單以色塊+文字呈現，極具直觀

VC++ 影像處理實戰：灰度與偽彩色圖像互轉核心算法詳解

前言：為什麼需要灰度/彩色轉換？ 工業檢測、醫學影像、電腦視

DLL 全面剖析（三）：調用約定與名字修飾深度解析

調用約定：參數傳遞與棧平衡的協定 調用約定決定：參數入棧順序

VC++ 可設定單元格顏色的 CListCtrl 擴充：NM_CUSTOMDRAW 實作逐格著色

前言 標準 `CListCtrl` 僅支援整行選取色、交替行