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 ;

}