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 [仅限桌面应用] |
标头 |
|