LB_DIR消息
将名称添加到列表框显示的列表。 该消息添加与指定字符串和文件属性集匹配的目录和文件的名称。 LB_DIR 还可以将映射的驱动器号添加到列表框。
参数
-
wParam
-
要添加到列表框的文件或目录的属性。 此参数可使用以下一个或多个值。
值 含义 - DDL_ARCHIVE
包括存档的文件。 - DDL_DIRECTORY
包括子目录。 子目录名称用方括号括起来， ([ ]) 。 - DDL_DRIVES
所有映射的驱动器都会添加到列表中。 驱动器以 [-x-] 的形式列出，其中 x 是驱动器号。 - DDL_EXCLUSIVE
仅包含具有指定属性的文件。 默认情况下，即使未指定DDL_READWRITE，也会列出读/写文件。 - DDL_HIDDEN
包括隐藏文件。 - DDL_READONLY
包括只读文件。 - DDL_READWRITE
包括没有其他属性的读/写文件。 这是默认设置。 - DDL_SYSTEM
包括系统文件。 -
lParam
-
指向以 null 结尾的字符串的指针，该字符串指定绝对路径、相对路径或文件名。 绝对路径可以以驱动器号开头， (例如 d：) 或 UNC 名称 (例如 \\ machinename\ sharename) 。
如果字符串指定具有 wParam 参数指定的属性的文件名或目录，则会将文件名或目录添加到列表中。 文件名或目录名称是否包含通配符 (？或 *) ，与通配符表达式匹配且具有 wParam 参数指定属性的所有文件或目录都会添加到列表中。
返回值
如果消息成功，则返回值为添加到列表的姓氏的从零开始的索引。
如果发生错误，则返回值LB_ERR。 如果没有足够的空间来存储新字符串，则返回值LB_ERRSPACE。
备注
LB_INITSTORAGE消息有助于加快包含大量项 (超过 100) 的列表框的初始化。 它保留指定的内存量，以便后续 LB_DIR 消息花费尽可能短的时间。 可以使用 wParam 和 lParam 参数的估计值。 如果高估，则会分配额外的内存;如果低估，则正常分配用于超出请求金额的项。
如果 wParam 包含 DDL_DIRECTORY 标志， 并且 lParam 指定第一级目录（如 C：\TEMP\*）的所有子目录，则列表框将始终包含根目录的“..”条目。 即使根目录具有隐藏或系统属性，并且未指定DDL_HIDDEN和DDL_SYSTEM标志，也是如此。 NTFS 卷的根目录具有隐藏属性和系统属性。
该列表显示长文件名（如果有）。
对于 ANSI 应用程序，系统会使用 CP_ACP 将列表框中的文本转换为 Unicode。 这可能会导致问题。 例如，日语 Windows 中非 Unicode 列表框中的重音罗马字符会出现乱码。 若要解决此问题，请将应用程序编译为 Unicode 或使用所有者绘制的列表框。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
| 标头 |
|