学步园

在编制Windows应用程序时，常常要用到这样的一种功能：显示一个模式对话框，要求用户指定一个文件夹，如图所示。这个功能看起来很简单，其实不然，因为首先，Windows是一具多任务的操作系统，在这个对话框显示期间，用户或其它的进程可能创建或删除了某个文件夹，或者改变了文件夹的图标，或者改变了系统文件夹的映射（如我的文档的位置），这些都会影响这个对话框中的内容，而且，这个对话框的风格最好与当前版本的Windows保持一致。从编程角度来讲，它应当有着最好的性能并占用最少量的内存。一个功能良好的应用程序应当能够处理所有上述的情况以及其它可以预见的情况。这样看来，编制这个对话框就成了一个非常繁重的任务。  
  那么，有没有一个简便易行的方法来实现所有的这些功能呢？我们可以求助于一个外壳API函数：SHBrowseForFolder。这个函数以当前系统默认的风格显示一个对话框，并且可以有效地控制它的行为，所有的难于处理的问题都留给了Explorer去处理，我们只需简单地取出字符串即可。SHBrowseForFolder的说明如下：  
  WINSHELLAPI   LPITEMIDLIST   WINAPI   SHBrowseForFolder(  
          LPBROWSEINFO   lpbi  
  );  
  SHBrowseForFolder函数返回一个ITEMIDLIST结构的指针，这个结构包含了用户选择文件夹的信息，需要注意的是，SHBrowseForFolder函数要求调用程序负责删除这个指针。如果用户选择了“取消”按钮，则返回NULL。SHBrowseForFolder函数的参数是一个BROWSEINFO结构变量，它的定义如下：  
  typedef   struct   _browseinfo   {    
          HWND   hwndOwner;   //   父窗口的句柄  
          LPCITEMIDLIST   pidlRoot;   //   一个ITEMIDLIST结构变量，指定根目录  
          LPSTR   pszDisplayName;   //    
          LPCSTR   lpszTitle;   //   位于对话框顶端的一行文字  
          UINT   ulFlags;   //   标志变量，按位有效  
          BFFCALLBACK   lpfn;   //   回调函数  
          LPARAM   lParam;   //   传给回调函数的参数，一个32位值  
          int   iImage;   //   被选择的文件夹的图片序号，与shell32.dll中的图标号同  
  }   BROWSEINFO,   *PBROWSEINFO,   *LPBROWSEINFO;  
  ulFlags参数在浏览文件夹时一般取值为BIF_BROWSEFORCOMPUTER，这样，对话框将只允许指定在实际文件系统中存在的文件夹，否则“确定”按钮将会被禁用。  
  如果SHBrowseForFolder函数返回的ITEMIDLIST结构指针不为NULL，就可以使用SHGetPathFromIDList函数取得存储于ITEMIDLIST结构指针中的路径信息。SHGetPathFromIDList函数的原型如下：  
  WINSHELLAPI   BOOL   WINAPI   SHGetPathFromIDList(  
          LPCITEMIDLIST   pidl,  
          LPSTR   pszPath  
  );  
  第一个参数就是存储了路径信息的ITEMIDLIST结构指针，第二个参数是一个字符缓冲区，用于接收字符串。它应当有_MAX_PATH所指定的长度，_MAX_PATH在Windows系统中被定义为260个字符，其大小可以是260或520个字节，这取决于是否使用了Unicode。  
  现在，让我们来制作一个工程。打开App   Wizard，创建一个MFC   EXE对话框工程，名为SelFolder，然后在Workspace窗口的FileView中将SelFolder.rc，SelFolder.h，SelFolderDlg.h，SelFolderDlg.cpp，Resource.h及以Res文件夹都删除，只保留SelFolder.cpp、Stdafx.h和Stdafx.cpp三个文件，现将SelFolder.cpp文件修改如下：  
   
  #include   "stdafx.h"  
   
  struct   CSelFolderApp   :   public   CWinApp  
  {  
  virtual   BOOL   InitInstance();  
  }   theApp;  
   
  BOOL   CSelFolderApp::InitInstance()  
  {  
  //   要求Windows   95/NT4   或更新版本  
  ASSERT(LOBYTE(LOWORD(GetVersion()))   >=   4);  
   
  TCHAR   szPath[_MAX_PATH];  
  BROWSEINFO   bi;  
  //   指定父窗口，在对话框显示期间，父窗口将被禁用  
  bi.hwndOwner   =   NULL;  
  //   如果指定NULL，就以“桌面”为根  
  bi.pidlRoot   =   NULL;  
  //   这一行将显示在对话框的顶端  
  bi.lpszTitle   =     _T("请选择一个文件夹");  
  bi.pszDisplayName   =   szPath;  
  //   只返回文件系统中存在的文件夹  
  bi.ulFlags   =   BIF_RETURNONLYFSDIRS;  
  bi.lpfn   =   NULL;   //   回调函数的指针  
  bi.lParam   =   NULL;   //   传向回调函数的参数  
   
  //   现在，调用函数来显示对话框  
  //   它总与Windows的外壳程序Explorer保持相同的外观  
  LPITEMIDLIST   pItemIDList   =   SHBrowseForFolder(   &bi   );  
   
  if   (   pItemIDList   )   //   点按了“确定”按钮  
  {  
  TCHAR   szPath[   _MAX_PATH   ];  
  if   (   SHGetPathFromIDList(pItemIDList,   szPath)   )  
  {  
  //   成功地取得了文件夹信息  
  CString   strMessage;  
  strMessage.Format("选定的文件夹是/'%s/'",   szPath);  
  AfxMessageBox(   strMessage   );  
  }  
  //   防止内存泄漏，要使用IMalloc接口  
  IMalloc*   pMalloc;  
  if   (   SHGetMalloc(   &pMalloc   )   !=   NOERROR   )  
  {  
  //   未返回有效的IMalloc接口指针  
  TRACE(_T("无法取得外壳程序的IMalloc接口/n"));  
  }  
  pMalloc->Free(   pItemIDList   );  
  if   (   pMalloc   )  
  pMalloc->Release();  
  }  
   
  //   已完成任务，所以返回FALSE来终止进程  
  return   FALSE;  
  }   //   InitInstance