BROWSEINFO的结构介绍之获取文件(夹)路径

Visual C++(VC)中，BROWSEINFO结构中包含有用户选中目录的重要信息。

（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：与选中目录相关的图像。该图像将被指定为系统图像列表中的索引值。

相关函数介绍：

1、WINSHELLAPI LPITEMIDLIST WINAPI SHBrowseForFolder( LPBROWSEINFO lpbi); //调用显示选择对话框

2、功能是把项目标志符列表转换为文档系统路径：

BOOL SHGetPathFromIDList(

LPCITEMIDLIST pidl,

LPSTR pszPath

);

参数：

pidl--- 一张相对于namespace的根( 桌面)的项目标识符表地址，用于指定一个文档或目录地点；

pszPath---接收文档系统路径的缓冲地址，大小至少是MAX_PATH的字符长度

3、 WINSHELLAPI HRESULT WINAPI SHGetSpecialFolderLocation (HWND hwndOwner, int nFolder,LPITEMIDLIST * ppidl); //函数声明

hwndOwner: 指定了"所有者窗口",在调用这个函数是可能出现的对话框或信息框.

nFolder: 是一个整数id，决定哪个目录是待查找目录,它的取值可能是

CSIDL_BITBUCKET 回收站

CSIDL_CONTROLS 控制面板

CSIDL_DESKTOP Windows 桌面desktop;

CSIDL_DESKTOPDIRECTORY desktop的目录；

CSIDL_DRIVES 我的电脑

CSIDL_FONTS 字体目录

CSIDL_NETHOOD 网上邻居

CSIDL_NETWORK 网上邻居virtual folder

CSIDL_PERSONAL 我的文档

CSIDL_PRINTERS 打印机

CSIDL_PROGRAMS 程序组

CSIDL_RECENT 最近打开文档

CSIDL_SENDTO 发送到菜单项

CSIDL_STARTMENU 快启菜单(开始菜单)

CSIDL_STARTUP 启动目录

CSIDL_TEMPLATES 临时文档

ppidl: pidl地址. SHGetSpecialFolderLocation把地址写到pidl.

实例一：

char szPath[256];

BROWSEINFO bi;
LPITEMIDLIST pIDL;
bi.hwndOwner = m_hWnd;
bi.pidlRoot = NULL;
bi.pszDisplayName = szPath; 
bi.lpszTitle = m_strTitle;
bi.ulFlags = BIF_RETURNONLYFSDIRS;
bi.lpfn = NULL;
bi.lParam = 0;
bi.iImage = 0;
pIDL = SHBrowseForFolder( &bi );
if(SHGetPathFromIDList(pIDL,szPath))
{
m_sMapPath = szPath;
UpdateData(FALSE);
}

实例2

//获取路径
CString CMyDlg::BrowseDlg(CString lpszTitle)
{
ITEMIDLIST *ppidl;
SHGetSpecialFolderLocation(NULL, CSIDL_DESKTOP ,&ppidl);
if ( ppidl == NULL)
{
AfxMessageBox(_T("启动路径浏览失败") ) ; 
return _T("error");
}
TCHAR path[255] = _T("");
BROWSEINFO *bi=new BROWSEINFO;
bi->hwndOwner=NULL;
bi->pidlRoot=ppidl;  
bi->pszDisplayName=NULL;     
bi->lpszTitle=lpszTitle;     
bi->lpfn=NULL;
bi->ulFlags=/*BIF_BROWSEINCLUDEFILES|*/BIF_EDITBOX |BIF_RETURNONLYFSDIRS  ;
ppidl = SHBrowseForFolder(bi); 
if ( !SHGetPathFromIDList(ppidl,path) ) 
{
delete bi;
return _T("error") ; 
}
delete bi;
CString s = path ; 
if ( s.Right( 1 ) != _T("\\") ) 
s+= _T("\\") ; 

return s ; 
}