typedef struct _browseinfo {
HWND hwndOwner; // 父視窗句柄
LPCITEMIDLIST pidlRoot; // 要顯示的資料夾的根(Root)
LPTSTR pszDisplayName; // 保存被選取的資料夾路徑的緩衝區
LPCTSTR lpszTitle; // 顯示位於對話框左上部的標題
UINT ulFlags; // 指定對話框的外觀和功能的標誌
BFFCALLBACK lpfn; // 處理事件的回調函數
LPARAM lParam; // 應用程式傳給回調函式的參數
int iImage; // 保存被選取的資料夾的圖片索引
} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO
●成員變數
hwndOwner:瀏覽資料夾對話框的父窗體句柄。
pidlRoot:ITEMIDLIST結構的地址,包含瀏覽時的初始根目錄,而且只有被指定的目錄和其子目錄才顯示在瀏覽資料夾對話框中。該成員變數可以是NULL,在此時桌面目錄將被使用。
pszDisplayName:用來保存用戶選中的目錄字元串的記憶體地址。該緩衝區的大小預設是定義的max_path常量宏。
lpszTitle:該瀏覽資料夾對話框對話框的顯示文本,用來提示該瀏覽資料夾對話框的功能、作用和目的。
ulFlags:該標誌位描述了對話框的選項。它可以為0,也可以是以下常量的任意組合:
BIF_BROWSEFORCOMPUTER:返回計算機名。除非用戶選中瀏覽器中的一個計算機名,否則該對話框中的“OK”按鈕為灰色。
BIF_BROWSEFORPRINTER:返回印表機名。除非選中一個印表機名,否則“OK”按鈕為灰色。
BIF_BROWSEINCLUDEFILES:瀏覽器將顯示目錄,同時也顯示檔案。
BIF_DONTGOBELOWDOMAIN:在樹形視窗中,不包含域名底下的網路目錄結構。
BIF_EDITBOX:瀏覽對話框中包含一個編輯框,在該編輯框中用戶可以輸入選中項的名字。
BIF_RETURNFSANCESTORS:返回檔案系統的一個節點。僅僅當選中的是有意義的節點時,“OK”按鈕才可以使用。
BIF_RETURNONLYFSDIRS:僅僅返回檔案系統的目錄。例如:在瀏覽資料夾對話框中,當選中任意一個目錄時,該“OK”按鈕可用,而當選中“我的電腦”或“網上鄰居”等非有意義的節點時,“OK”按鈕為灰色。
BIF_STATUSTEXT:在對話框中包含一個狀態區域。通過給對話框傳送訊息使回調函式設定狀態文本。
BIF_VALIDATE:當沒有BIF_EDITBOX標誌位時,該標誌位被忽略。如果用戶在編輯框中輸入的名字非法,瀏覽對話框將傳送BFFM_VALIDATEFAILED訊息給回調函式。
lpfn:應用程式定義的瀏覽對話框回調函式的地址。當對話框中的事件發生時,該對話框將調用回調函式。該參數可用為NULL。
lParam:對話框傳遞給回調函式的一個參數指針。
iImage:與選中目錄相關的圖像。該圖像將被指定為系統圖像列表中的索引值。
調用例子如下:
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.iImage=IDI_ICON2;
bi.lParam=0;
//初始化入口參數bi結束
LPITEMIDLIST pIDList = SHBrowseForFolder(&bi);//調用顯示選擇對話框
if(pIDList)
{
SHGetPathFromIDList(pIDList, Buffer);
//取得資料夾路逕到Buffer里
sFolderPath = Buffer;//將路徑保存在一個CString對象里
}
LPMALLOC lpMalloc;
if(FAILED(SHGetMalloc(&lpMalloc))) return;
//釋放記憶體
lpMalloc->Free(pIDList);
lpMalloc->Release();
}
函式在VB6中使用時
聲明(declare):
Declare Function SHBrowseForFolder Lib "shell32" (lpbi As BrowseInfo) As Long