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_ADDSTRINGLB_INSERTSTRINGLB_DIRLB_ADDFILE 消息花费尽可能短的时间。 可以对 wParamlParam 参数使用估算值。 如果高估,则会分配额外的内存;如果低估,则正常分配用于超出请求数量的项。

要求

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

另请参阅

引用

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING