关于BROWSEINFO结构

关于BROWSEINFO结构

MFC程序   2009-01-11 15:47

BROWSEINFO的结构如下:

typedef struct _browseinfo { 

    HWND hwndOwner;        

       // 父窗口句柄

    LPCITEMIDLIST pidlRoot;              

      // 要显示的文件夾的根(Root)

    LPTSTR pszDisplayName; 

      // 保存被选取的文件夾路径的缓冲区

    LPCTSTR lpszTitle;            

       // 显示位于对话框左上部的标题

    UINT ulFlags;              

      // 指定对话框的外观和功能的標志

    BFFCALLBACK lpfn;                    

      // 处理事件的回调函数

    LPARAM lParam;               

      // 应用程序传给回调函数的参数

    int iImage;               

      // 保存被选取的文件夾的图片索引

} BROWSEINFO, *PBROWSEINFO, *LPBROWSEINFO

pszDisplayName
   -- 這個参数指向一個缓冲区,SHBrowseForFolder默认这个缓冲区的大小为MAX_PATH(系统定义的宏,表示一个路径名的最大长度),并用它来保存被选取的文件夹的路径。

  ulFlags --
  SHBrowseForFolder允许我们指定对话框的功能和外观,这个参数正是起这样的用途。它的值可以由十几个宏组合而成。比如BIF_RETURNNONLYFSDIRS是返回文件系统的目录,BIF_BROWSEFORCOMPUTER是返回网络上的计算机名,BIF_EDITBOX是显示一个编辑框,允许用户输入文件夾名。一般来说,如果是简单的用于选择一个文件夹,设置ulFlags = BIF_RETURNONLYLYFSDIRS即可。


  pidRoot --
  它指向一个ITEMIDLIST结构,作为在列表中显示的文件夹的根目录,如果为NULL則默认为Desktop。ITEMIDLIST结构除了用在这里外,它还用作函数的返回值(參看函数原型)。那为什么不用字符串来表示这个目录呢,这个结构怎样表示一个目录呢?下面作一個简单的介紹。

ITEMID和ITEMIDLIST

  Windows Shell的一个功能在于管理并提供方法存取系统中的众多对像,這些对像包括了文件,网路上的计算机,控制面板程序,回收站等等,为了识别每一个对像,Windows Shell使用了Item ID来表示它們,而Iten ID Lists用来表示一个对像的路径。所以,ITEMID和ITEMIDLIST的关系类似于文件名和路径的关系。如果只对文件系统而言的话,ITEMIDLIST可以看成是路径的另一中表示法,Windows Shell也提供了函数來进行转化。

  BOOL SHGetPathFromIDList( LPCITEMIDLIST pidl, LPSTR pszPath )
 这个函数將一个ITEMLIST转换成文件系统中的路径。

返回值

  SHBrowseForFolder的返回值也是一个指向ITEMIDLIST的指針。这个ITEMIDLIST正式表示了用戶所选择的文件夹。如上所述,通过SHGetPathFromIDList,就可以获得一个文件夹Path的字符串。

  要注意的是返回的指針必须由应用程序自己来释放。并且,由于SHBrowseForFolder是通贵调用IMalloc Interface来分配Memory,所以,也必须通过这个Interface來释放。

实例:

关于BROWSEINFO结构(转) - 睡梦中的羽翼 - VCVS学习中

posted on 2011-02-18 10:15  carekee  阅读(2634)  评论(0编辑  收藏  举报