请输入您要查询的百科知识:

 

词条 SHBrowseForFolder
释义

BROWSEINFO的结构如下:

typedef struct _browseinfo {

HWND hwndOwner; // 父窗口句柄

LPCITEMIDLIST pidlRoot; // 要显示的文件夹的根(Root)

LPTSTR pszDisplayName; // 保存被选取的文件夹路径的缓冲区

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

调用例子如下:

void CMakemifDlg::OnRecPcpath()

{

CString sFolderPath;

BROWSEINFO bi;

char Buffer[MAX_PATH];

//初始化入口参数bi开始

bi.hwndOwner = NULL;

bi.pidlRoot = NULL;

bi.pszDisplayName = Buffer;//此参数如为NULL则不能显示对话框

bi.lpszTitle = "修改接收路径";

bi.ulFlags = 0;

bi.lpfn = NULL;

bi.iImage=IDI_ICON2;

bi.lParam=0;

//初始化入口参数bi结束

LPITEMIDLIST pIDList = SHBrowseForFolder(&bi);//调用显示选择对话框

if(pIDList)

{

SHGetPathFromIDList(pIDList, Buffer);

//取得文件夹路径到Buffer里

sFolderPath = Buffer;//将路径保存在一个CString对象里

}

LPMALLOC lpMalloc;

if(FAILED(SHGetMalloc(&lpMalloc))) return;

//释放内存

lpMalloc->Free(pIDList);

lpMalloc->Release();

}

函数在VB6中使用时

声明(declare):

Declare Function SHBrowseForFolder Lib "shell32" (lpbi As BrowseInfo) As Long

随便看

 

百科全书收录4421916条中文百科知识,基本涵盖了大多数领域的百科知识,是一部内容开放、自由的电子版百科全书。

 

Copyright © 2004-2023 Cnenc.net All Rights Reserved
更新时间:2025/3/2 0:47:42