DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 Visual C++ 呼叫 Shell 的資料夾瀏覽對話框
編輯:AJAX詳解     

我們常需要取得某個資料夾的路徑,而不是檔案的路徑。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。

寫法一:MFC 對話框成員函式

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;
}

幾個實務上的修正與提醒

上面第二段範例的原始寫法有幾處值得調整,這裡一併說明:

  1. PIDL 一定要釋放。原始寫法在 SHGetPathFromIDList 成功後直接 return,跳過了 Free 與 Release,每次都會漏掉一塊記憶體與一個 COM 物件的參考計數。長時間執行的程式會因此慢慢耗盡資源。
  2. 不要用 return 繞過清理流程。建議改用單一出口,或在每個分支前完成清理,也可以直接在函式開頭取得 IMalloc 後用 RAII 包裝。
  3. 選「網路位置」時路徑會是空的。SHGetPathFromIDList 對非檔案系統項目會失敗或回傳空字串,這正是 szBuffer[0] == '\0' 檢查的用意。若需要支援這類項目,可改用 StrRetToBuf 搭配 IShellFolder::GetDisplayNameOf 取得顯示名稱。
  4. 更現代的替代方案。Windows Vista 以後建議改用 IFileDialog 並設定 FOS_PICKFOLDERS,它支援新的挑選器樣式、可加上自訂地點與完成事件。若要相容舊系統,則可考慮 PickFolder 這種把上述邏輯封裝好的現成類別。
  5. 記得連結 shell32.lib。忘了這步會出現 unresolved external symbol 的連結錯誤。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved