Windows Shell 程式設計實作：打造網路芳鄰目錄樹瀏覽器

利用 Windows Shell API（shell32.dll、shlobj.h）可輕鬆實作類似「網路芳鄰」的目錄樹瀏覽功能。本文提供完整 C++Builder 程式碼，展示如何透過 IShellFolder、PIDL、IMalloc 等核心介面遞迴列舉網路資源並填充 TTreeView。

核心類別與介面速查

關鍵實作步驟

1. 初始化 Shell 環境：SHGetMalloc 取得 IMalloc、SHGetDesktopFolder 取得桌面 IShellFolder、SHGetSpecialFolderLocation(CSIDL_NETWORK) 取得網路芳鄰 PIDL。
2. 建立根節點：透過 GetDisplayNameOf 取得顯示名稱，SHGetFileInfo 取得系統圖示索引，加入 TTreeView。
3. 遞迴列舉子資料夾（BrowseFolder）：
   • BindToObject 取得子資料夾的 IShellFolder
   • EnumObjects(SHCONTF_FOLDERS | SHCONTF_INCLUDEHIDDEN) 取得列舉器
   • 迴圈 Next 取得每個子項 PIDL
   • MergeIDList 合併父 PIDL 與子 PIDL 形成完整路徑 PIDL
   • SHGetFileInfo 取得圖示與顯示名稱
   • 若具 SFGAO_HASSUBFOLDER 屬性，加入虛擬子節點「PP」實現延遲載入
   • 將 TDir 結構（含 ParentShellFolder、pidl、ppidl、Sfogliato）掛載至 TreeNode->Data
4. 動態展開（TreeViewExpanding）：節點展開時檢查 Sfogliato 標記，未瀏覽過則呼叫 BrowseFolder 載入子節點並移除虛擬節點。
5. 點選顯示路徑（TreeViewClick）：SHGetPathFromIDList 將 PIDL 轉為檔案系統路徑（若適用）。

關鍵輔助函式

// 合併兩個 PIDL
LPITEMIDLIST MergeIDList(LPITEMIDLIST a, LPITEMIDLIST b) {
    int cb1 = a ? GetPIDLSize(a) - 2 : 0;
    int cb2 = b ? GetPIDLSize(b) - 2 : 0;
    LPITEMIDLIST result = (LPITEMIDLIST)m_alloc->Alloc(cb1 + cb2 + 2);
    CopyMemory(result, a, cb1);
    CopyMemory((LPBYTE)result + cb1, b, cb2);
    FillMemory((LPBYTE)result + cb1 + cb2, 2, 0);
    return result;
}

// 計算 PIDL 總大小（含終止雙零）
int GetPIDLSize(LPITEMIDLIST pidl) {
    unsigned short cb = 0;
    while (pidl) {
        cb += pidl->mkid.cb;
        pidl = GetNextItem(pidl);
    }
    return cb + 2;
}

// 取得下一個 PIDL 項目
LPITEMIDLIST GetNextItem(LPITEMIDLIST pidl) {
    unsigned short len = pidl->mkid.cb;
    return len ? (LPITEMIDLIST)((LPBYTE)pidl + len) : NULL;
}

記憶體管理鐵律

• 所有 IMalloc::Alloc 配置的記憶體（PIDL、STRRET 緩衝區）必須配對 Free 釋放。
• IEnumIDList::Release、IShellFolder::Release 遵循 COM 參考計數規則。
• TDir 結構體由 new 配置，需在節點刪除或表單銷毀時手動 delete（範例中省略，實務必補全）。

常見坑點與對策

完整程式碼已整合於表單 TForm1 中，包含建構子初始化、BrowseFolder 遞迴列舉、GetNome 多格式名稱解析、PIDL 合併/大小計算、樹狀視圖事件處理。此架構易於擴充為完整的 Shell 瀏覽器元件。

1. 上一篇文章： C++ 編譯器選擇指南：Bjarne Stroustrup 親授的避坑清單
2. 下一篇文章： Managed C++ 開發自訂 Web 組合控件：從零打造可複用的 SearchControl

關於C++

STL 排序算法全解析：從 sort 到 partition 的選擇藝術

前言：為何必須精通 STL 排序 排序是程式設計中最高頻算法

C++ 同步讀寫文字檔（生產者/消費者模式）

場景 寫入程式每 2 秒寫入一個數字；讀取程式每 5 秒讀取

C++ 物件模型深度解析：預設建構函數合成時機與操作詳解

核心結論 編譯器只在必要時合成預設建構函數 (implici

XP 使用者模式記憶體空間剖析（四）：主程式載入佈局與 PE 區段對應

主程式模組資訊 bash.exe 基址 0x00400000