LB_INITSTORAGE消息
分配用于存储列表框项的内存。 此消息在应用程序将大量项添加到列表框之前使用。
参数
-
wParam
-
要添加的项数。
Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam 参数限制为 16 位值。 这意味着列表框不能包含超过 32,767 个项。 尽管项数受到限制,但列表框中项的总大小(以字节为单位)仅受可用内存的限制。
-
lParam
-
要为项字符串分配的内存量(以字节为单位)。
返回值
如果消息成功,则返回值是已为其预分配内存的项总数,即所有成功 LB_INITSTORAGE 消息添加的项总数。
如果消息失败,则返回值LB_ERRSPACE。
Microsoft Windows NT 4.0:此消息不分配指定的内存量;但是,它始终返回 wParam 参数中指定的值。
备注
LB_INITSTORAGE消息有助于加快列表框的初始化速度,这些列表框具有大量项 (超过 100) 。 它保留指定的内存量,以便后续 LB_ADDSTRING、 LB_INSERTSTRING、 LB_DIR和 LB_ADDFILE 消息花费尽可能短的时间。 可以对 wParam 和 lParam 参数使用估算值。 如果高估,则会分配额外的内存;如果低估,则正常分配用于超出请求数量的项。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
标头 |
|