使用SHBrowseForFolder函數(shù)打開文件目錄對話框

 

自從第一份工作辭職后，差不多三年多沒有再搞MFC了，對于微軟的Windows桌面開發(fā)真的淡忘了，這次接到一個任務(wù)，需要開發(fā)個小工具，雖然任務(wù)很小，但是在一個如何打開文件目錄對話框的小問題上卡了下，雖然通過網(wǎng)絡(luò)找到了解決方法，但是網(wǎng)上七拼八湊的文章太多，看的有點費時，所以就抽時間小結(jié)一下，雖然也是簡單使用，沒有太多擴展，就當(dāng)給自己Mark一下吧。

關(guān)于SHBrowseForFolder函數(shù)和簡單使用

打開文件目錄對話框，我找到的方法就是使用SHBrowseForFolder函數(shù)，這個函數(shù)的原型是LPITEMIDLIST SHBrowseForFolder(LPBROWSEINFO lpbi)。函數(shù)很簡單，就一個返回值和一個參數(shù)。參數(shù)簡單羅列如下

typedef struct _browseinfo {

     HWND hwndOwner;            // 父窗口句柄

     LPCITEMIDLIST pidlRoot;    // 要顯示的文件目錄對話框的根(Root)

     LPTSTR pszDisplayName;     // 保存被選取的文件夾路徑的緩沖區(qū)

     LPCTSTR lpszTitle;         // 顯示位于對話框左上部的標(biāo)題

     UINT ulFlags;              // 指定對話框的外觀和功能的標(biāo)志

     BFFCALLBACK lpfn;          // 處理事件的回調(diào)函數(shù)

     LPARAM lParam;             // 應(yīng)用程序傳給回調(diào)函數(shù)的參數(shù)

     int iImage;                // 文件夾對話框的圖片索引

} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO

一般而言父窗口句柄（hwndOwner）和根（pidlRoot）設(shè)置為Null就可以了，pszDisplayName設(shè)定一塊MAX_PATH大小的緩沖區(qū)，跟顯示相關(guān)的參數(shù)就是對話框提示標(biāo)題（lpszTitle）、對話框樣式（ulFlags）、設(shè)定對話框的缺省路徑的操作（lpfn和lParam）以及對話框任務(wù)欄上顯示的圖標(biāo)（iImage）。

由于返回值LPITEMIDLIST是一個指向ITEMIDLIST的指針，這個ITEMIDLIST涉及到Windows Shell中關(guān)于管理諸如文件、網(wǎng)絡(luò)上的計算機、控制面板程序、回收站等等對象的知識點，Windows Shell為了識別具體的每一個對象，就使用了ITEMID來唯一識別和區(qū)分，而ITEMIDLIST就是一個完整的對象路徑。顯然這個函數(shù)可以用來瀏覽非文件對象，比如局域網(wǎng)內(nèi)的電腦等等，在這里這個LPITEMIDLIST返回的對象路徑是一個文件夾的路徑，Windows提供了一個函數(shù)BOOL SHGetPathFromIDList(LPCITEMIDLIST pidl, LPSTR pszPath)來實現(xiàn)從對象路徑轉(zhuǎn)化為文件夾路徑。

在這里需要注意的是，這個返回值是通過調(diào)用IMalloc Interface來分配內(nèi)存的，函數(shù)并不負(fù)責(zé)釋放內(nèi)存操作，所以我們在使用完這個返回值之后，必須通過IMalloc Interface來釋放內(nèi)存。

下面給出一段最簡單的使用代碼

       BROWSEINFO bi;

       char Buffer[MAX_PATH];

       //初始化入口參數(shù)bi開始

       bi.hwndOwner = NULL;

       bi.pidlRoot =NULL;//初始化制定的root目錄很不容易

       bi.pszDisplayName = Buffer;//此參數(shù)如為NULL則不能顯示對話框

       bi.lpszTitle = "選擇Sis目標(biāo)文件路徑";

       bi.ulFlags = BIF_EDITBOX;//帶編輯框的風(fēng)格

       bi.lpfn = NULL;

       bi.lParam = 0;

       bi.iImage=IDR_MAINFRAME;

       //初始化入口參數(shù)bi結(jié)束

       LPITEMIDLIST pIDList = SHBrowseForFolder(&bi);//調(diào)用顯示選擇對話框

       if(pIDList)

       {

          SHGetPathFromIDList(pIDList, Buffer);

          //取得文件夾路徑到Buffer里

          CString m_cSisDes = Buffer;//將路徑保存在一個CString對象里

       }

       UpdateData(FALSE);

 

       // free memory used     

    IMalloc * imalloc = 0;

       if (SUCCEEDED(SHGetMalloc(&imalloc)))

       {

              imalloc->Free (pIDList);

              imalloc->Release();

       }

如上代碼可以顯示一個最簡單的帶編輯框的其實選中對象為我的電腦的瀏覽文件夾對話框。

創(chuàng)建一個可以新建文件夾且指定選中初始路徑的瀏覽文件夾對話框

由于我在實際工作中需要的就是一個有新建文件夾功能且指定初始選中路徑的瀏覽文件夾對話框，就把這個需求當(dāng)做擴展應(yīng)用吧，由于對話框樣式由ulFlags標(biāo)記確定，而在系統(tǒng)頭文件SHLOBJ.h頭文件中給出的對話框樣式只有如下幾種

// Browsing for directory.

#define BIF_RETURNONLYFSDIRS   0x0001  // For finding a folder to start document searching

#define BIF_DONTGOBELOWDOMAIN  0x0002  // For starting the Find Computer

#define BIF_STATUSTEXT         0x0004

#define BIF_RETURNFSANCESTORS  0x0008

#define BIF_EDITBOX            0x0010

#define BIF_VALIDATE           0x0020   // insist on valid result (or CANCEL)

 

#define BIF_BROWSEFORCOMPUTER  0x1000  // Browsing for Computers.

#define BIF_BROWSEFORPRINTER   0x2000  // Browsing for Printers

#define BIF_BROWSEINCLUDEFILES 0x4000  // Browsing for Everything

沒有滿足我需求的樣式，通過csdn查到其實有一個支持新建文件夾功能的樣式值0x40，通常網(wǎng)絡(luò)上給出宏為BIF_NEWDIALOGSTYLE和BIF_USENEWUI，由于不知道在具體哪個頭文件中，所以我們可以在代碼中自己定義一下這兩個宏，具體如下

#define BIF_NEWDIALOGSTYLE   0x40

#define BIF_USENEWUI (BIF_NEWDIALOGSTYLE|BIF_EDITBOX)

這樣一來第一個問題解決了，那么如何讓對話框有初始選中的文件夾路徑呢，我起初想著通過pidlRoot，結(jié)果撞了一鼻子灰，原來設(shè)定初始選中文件夾路徑，是通過那個神奇的回調(diào)函數(shù)來實現(xiàn)，換句話來說你調(diào)用SHBrowseForFolder也就好比你調(diào)用了CDialog:: DoModal()函數(shù)，具體這個對話框里面的類似初始化，選擇等操作的不同實現(xiàn)就通過lpfn這個回調(diào)函數(shù)來實現(xiàn)了。

下面給出這個簡單擴展的代碼

#define BIF_NEWDIALOGSTYLE   0x40

 

int CALLBACK BrowseCallbackProc(HWND hwnd,UINT uMsg,LPARAM lParam,LPARAM lpData)  

{

       if(uMsg == BFFM_INITIALIZED)

       {  

              SendMessage(hwnd, BFFM_SETSELECTION, TRUE, lpData);

       }

       return 0;  

}

 

void CSisAppendMidDlg::OnButtonSisdes()

{

       // TODO: Add your control notification handler code here

       BROWSEINFO bi;

       char Buffer[MAX_PATH];

       //初始化入口參數(shù)bi開始

       bi.hwndOwner = NULL;

       bi.pidlRoot =NULL;//初始化制定的root目錄很不容易

       bi.pszDisplayName = Buffer;//此參數(shù)如為NULL則不能顯示對話框

       bi.lpszTitle = "選擇Sis目標(biāo)文件路徑";

       bi.ulFlags = BIF_EDITBOX|BIF_NEWDIALOGSTYLE;  

       CFileFind   finder;

       if(finder.FindFile(m_cSisDes)==FALSE)

       {

              bi.lParam =0;

              bi.lpfn = NULL;

       }

       else

       {

              bi.lParam = (long)(m_cSisDes.GetBuffer(m_cSisDes.GetLength()));//初始化路徑，形如(_T("c:\\Symbian"));

              bi.lpfn = BrowseCallbackProc;

       }

       finder.Close();

       bi.iImage=IDR_MAINFRAME;

       //初始化入口參數(shù)bi結(jié)束

       LPITEMIDLIST pIDList = SHBrowseForFolder(&bi);//調(diào)用顯示選擇對話框

       if(pIDList)

       {

          SHGetPathFromIDList(pIDList, Buffer);

          //取得文件夾路徑到Buffer里

          m_cSisDes = Buffer;//將路徑保存在一個CString對象里

       }

       UpdateData(FALSE);

 

       // free memory used     

    IMalloc * imalloc = 0;

       if ( SUCCEEDED(SHGetMalloc( &imalloc)))

       {

              imalloc->Free (pIDList);

              imalloc->Release();

       }

 

}

好了，簡單擴展就到這里為止，至于很多大神需要再做更深一步的擴展，那就沿著這個思路走下去就可以了。畢竟我目前也就走到這一步了，呵呵。