(1)BROWSEINFO結構
●定義
typedef struct_browseinfo
{
HWND hwndOwner;
LPCITEMIDLIST pidlRoot;
LPSTR pszDisplayName;
LPCSTR 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:與選中目錄相關的圖像。該圖像將被指定為系統圖像列表中的索引值。