我們常需要取得某個資料夾的路徑,而不是檔案的路徑。MFC 沒有現成的類別,但 Shell API 提供了現成方案:SHBrowseForFolder。
LPITEMIDLIST SHBrowseForFolder(LPBROWSEINFO lpbi);
唯一的參數是指向 BROWSEINFO 結構的指標:
typedef struct _browseinfo {
HWND hwndOwner;
LPCITEMIDLIST pidlRoot;
LPSTR pszDisplayName;
LPCSTR lpszTitle;
UINT ulFlags;
BFFCALLBACK lpfn;
LPARAM lParam;
int iImage;
} BROWSEINFO;
幾個容易踩到的欄位:
pidlRoot:設定瀏覽的根位置。填 NULL 表示從桌面開始。pszDisplayName:接收使用者所選項目名稱的緩衝區。這個欄位若為 NULL,對話框不會顯示——這是最常見的失敗原因。lpszTitle:顯示在對話框上的提示文字。ulFlags:行為旗標,例如 BIF_RETURNONLYFSDIRS 只允許選資料夾、BIF_RETURNFSANCESTORS 允許回傳上層節點。lpfn:瀏覽過程中的回呼函式,可自訂按鈕文字與行為,不需要時填 NULL。void CMakemifDlg::OnRecPcpath()
{
CString sFolderPath;
BROWSEINFO bi;
char Buffer[MAX_PATH];
// 初始化入口參數 bi
bi.hwndOwner = NULL;
bi.pidlRoot = NULL;
bi.pszDisplayName = Buffer; // 此參數若為 NULL 則無法顯示對話框
bi.lpszTitle = "修改接收路徑";
bi.ulFlags = 0;
bi.lpfn = NULL;
bi.lParam = 0;
bi.iImage = IDI_ICON2;
LPITEMIDLIST pIDList = SHBrowseForFolder(&bi); // 顯示選擇對話框
if (pIDList)
{
SHGetPathFromIDList(pIDList, Buffer); // 取得資料夾路徑
sFolderPath = Buffer; // 存進 CString 物件
}
LPMALLOC lpMalloc;
if (FAILED(SHGetMalloc(&lpMalloc))) return;
lpMalloc->Free(pIDList); // 釋放 PIDL
lpMalloc->Release();
}
實務上更常見的做法是包成一個獨立函式,直接輸出 CString:
#include <Shlobj.h>
int SelFolder(HWND hParent, CString &strFolder)
{
strFolder.Empty();
LPMALLOC lpMalloc;
if (::SHGetMalloc(&lpMalloc) != NOERROR) return 0;
char szDisplayName[_MAX_PATH];
char szBuffer[_MAX_PATH];
BROWSEINFO browseInfo;
browseInfo.hwndOwner = hParent;
browseInfo.pidlRoot = NULL; // 根目錄設為桌面
browseInfo.pszDisplayName = szDisplayName;
browseInfo.lpszTitle = "Select a folder";
browseInfo.ulFlags = BIF_RETURNFSANCESTORS | BIF_RETURNONLYFSDIRS;
browseInfo.lpfn = NULL;
browseInfo.lParam = 0;
LPITEMIDLIST lpItemIDList;
if ((lpItemIDList = ::SHBrowseForFolder(&browseInfo)) != NULL)
{
// 從 PIDL 取出所選資料夾的路徑
if (::SHGetPathFromIDList(lpItemIDList, szBuffer))
{
if (szBuffer[0] == '\0') return 0; // 空路徑
strFolder = szBuffer;
lpItemIDList = NULL; // 見下方說明
lpMalloc->Free(lpItemIDList);
lpMalloc->Release();
return 1;
}
else
{
lpMalloc->Free(lpItemIDList);
lpMalloc->Release();
return 1; // strFolder 為空
}
}
lpMalloc->Release();
return 0;
}
上面第二段範例的原始寫法有幾處值得調整,這裡一併說明:
SHGetPathFromIDList 成功後直接 return,跳過了 Free 與 Release,每次都會漏掉一塊記憶體與一個 COM 物件的參考計數。長時間執行的程式會因此慢慢耗盡資源。return 繞過清理流程。建議改用單一出口,或在每個分支前完成清理,也可以直接在函式開頭取得 IMalloc 後用 RAII 包裝。SHGetPathFromIDList 對非檔案系統項目會失敗或回傳空字串,這正是 szBuffer[0] == '\0' 檢查的用意。若需要支援這類項目,可改用 StrRetToBuf 搭配 IShellFolder::GetDisplayNameOf 取得顯示名稱。IFileDialog 並設定 FOS_PICKFOLDERS,它支援新的挑選器樣式、可加上自訂地點與完成事件。若要相容舊系統,則可考慮 PickFolder 這種把上述邏輯封裝好的現成類別。shell32.lib。忘了這步會出現 unresolved external symbol 的連結錯誤。