CB_DIR消息

将名称添加到组合框显示的列表。 该消息添加与指定字符串和文件属性集匹配的目录和文件的名称。 CB_DIR 还可以将映射的驱动器号添加到列表中。

参数

wParam

要添加到组合框的文件或目录的属性。 此参数可使用以下一个或多个值。

值	含义
DDL_ARCHIVE	包括存档的文件。
DDL_DIRECTORY	包括子目录，这些子目录括在方括号 ([ ]) 中。
DDL_DRIVES	所有映射的驱动器都会添加到列表中。 驱动器以 [-x-] 格式列出，其中 x 是驱动器号。
DDL_EXCLUSIVE	仅包含具有指定属性的文件。 默认情况下，即使未指定DDL_READWRITE，也会列出读/写文件。
DDL_HIDDEN	包括隐藏的文件。
DDL_READONLY	包括只读文件。
DDL_READWRITE	包括没有其他属性的读/写文件。 这是默认值。
DDL_SYSTEM	包括系统文件。

lParam

指向以 null 结尾的字符串的 LPCTSTR 指针，该字符串指定绝对路径、相对路径或文件名。 绝对路径可以以驱动器号开头， (例如 d：) 或 UNC 名称 (例如\\machinename\sharename) 。 如果字符串指定的文件名或目录具有 wParam 参数指定的属性，则文件名或目录将添加到列表中。 文件名或目录名称是否包含通配符 (？或 *) ，与通配符表达式匹配且具有 wParam 参数指定属性的所有文件或目录都会添加到组合框中显示的列表。

返回值

如果消息成功，则返回值为添加到列表中的姓氏的从零开始的索引。

如果发生错误，则返回值CB_ERR。 如果没有足够的空间来存储新字符串，则返回值CB_ERRSPACE。

备注

如果 wParam 包含 DDL_DIRECTORY 标志， 并且 lParam 指定第一级目录（如 C：\TEMP\*）的所有子目录，则列表框将始终包含根目录的“..”条目。 即使根目录具有隐藏或系统属性，并且未指定DDL_HIDDEN和DDL_SYSTEM标志，也是如此。 NTFS 卷的根目录具有隐藏属性和系统属性。

该列表显示长文件名（如果有）。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Winuser.h (包括 Windows.h)

另请参阅

引用

CB_ADDSTRING

CB_INSERTSTRING

DlgDirListComboBox