DlgDirListComboBox

【勇芳软件工作室】汉化HomePreviousNext

DlgDirListComboBox函数使用目录列表填充指定的组合框。它使用与指定属性和路径字符串匹配的所有文件,驱动器和子目录的名称填充列表。

int DlgDirListComboBox(

HWND 【hDlg】,//使用组合框处理对话框
LPTSTR 【lpPathSpec】,//指向路径或文件名字符串的指针
INT 【nIDComboBox】,//组合框的标识符
INT 【nIDStaticPath】,//静态控件的标识符
UINT 【文件类型】//要显示的文件属性
); 

参数

【hDlg】

标识包含组合框的对话框。

【lpPathSpec】

指向以下形式的以null结尾的字符串:

[【drive】:][\]][【directory】\[...]][【filename】]

如果指定的字符串包含驱动器或目录路径,则DlgDirListComboBox功能将在填充列表之前更改当前的驱动器和目录。列表填写完毕后,驱动器和目录路径将从【lpPathSpec】参数指定的字符串中删除。

【nIDComboBox】

在对话框中指定组合框控件的标识符。如果【nIDComboBox】为零,则DlgDirListComboBox函数假定不存在组合框,并且不尝试填充它。

【nIDStaticPath】

指定DlgDirListComboBox函数显示当前目录的静态文本控件的标识符。如果【nIDStaticPath】为零,DlgDirListComboBox假定不存在此类控制。

【文件类型】

指定要显示的文件的属性。它可以是以下值的任意组合:

含义
DDL_ARCHIVE包括归档文件。
DDL_DIRECTORY包括子目录。子目录名称括在方括号([ ])中。
DDL_DRIVES包括驱动器。驱动器以[-【x】-]的格式列出,其中【x】是驱动器盘符。
DDL_EXCLUSIVE仅包含具有指定属性的文件。默认情况下,即使未指定DDL_READWRITE,也会列出读写文件。
DDL_HIDDEN包括隐藏文件。
DDL_READONLY包含只读文件。
DDL_READWRITE包含没有附加属性的读写文件。
DDL_SYSTEM包括系统文件。
DDL_POSTMSGS将消息发送到应用程序的消息队列。默认情况下,DlgDirList功能将消息直接发送到对话框过程。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。例如,如果【lpPathSpec】指定的字符串不是有效路径,则该函数将失败。要获取扩展错误信息,请调用GetLastError.

备注

如果【lpszPathSpec】参数指向零长度字符串或指向一个驱动器,目录或__但不包含文件名__的字符串,则假定使用文件名*。*(通配符)。

Windows NT:

目录列表显示长文件名(如果有)。

Windows 95:

目录列表显示短文件名(8.3表单)。您可以使用SHGetFileInfoGetFullPathName函数获取相应的长文件名。

也可以看看

DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName,SHGetFileInfo