LB_INITSTORAGE消息

分配用于存储列表框项的内存。 在应用程序向列表框添加大量项目之前，可以使用此消息。

参数

wParam

要为其保留空间的项目数。

Windows 95/Windows 98/Windows Millennium Edition（Windows Me）： wParam 参数限制为 16 位值。 这意味着列表框不能包含超过 32,767 个项。 尽管项数受到限制，但列表框中项的总大小（以字节为单位）仅受可用内存的限制。

lParam

要为项字符串分配的额外内存量（以字节为单位）。

返回值

如果消息成功，则返回值是列表框在需要内存重新分配之前可以存储的项总数。

如果消息失败，则返回值LB_ERRSPACE。

Microsoft Windows NT 4.0：此消息未分配指定的内存量;但是，它始终返回 wParam 参数中指定的值。

注解

LB_INITSTORAGE消息有助于加快具有大量项的列表框的初始化（超过 100 个）。 它保留指定的内存量，以便后续 LB_ADDSTRING、 LB_INSERTSTRING、 LB_DIR和 LB_ADDFILE 消息更高效。 可以使用 wParam 和 lParam 参数的估计值。 如果超额计算，则分配额外的内存;如果低估，列表框将根据需要分配额外的内存。

存储字符串所需的内存包括 null 终止符。 因此，如果计划添加 100 个字符串，每个字符串的长度为 10 个字符，则传递的 wParam 为 100，lParam 为 100 × （10 + 1） × sizeof（TCHAR）。

要求

另请参阅

引用

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING