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表单)。您可以使用SHGetFileInfo或GetFullPathName函数获取相应的长文件名。
也可以看看
DlgDirList, DlgDirSelectComboBoxEx, GetFullPathName,SHGetFileInfo