LVM_SETITEMCOUNT消息

使列表视图控件为指定数量的项分配内存,或设置 虚拟列表视图控件中的虚拟项数。

参数

wParam

列表视图控件最终将包含的项数。

lParam

版本 4.70。 指定重置项计数后列表视图控件的行为的值。 该值可为以下项的组合:

含义
LVSICF_NOINVALIDATEALL
列表视图控件不会重新绘制,除非受影响的项当前位于视图中。
LVSICF_NOSCROLL
当项计数发生更改时,列表视图控件不会更改滚动位置。

返回值

如果成功,返回不为零的值;否则返回零。

注解

内存的分配方式取决于创建列表视图控件的方式。 可以显式发送此消息,也可以使用 ListView_SetItemCountListView_SetItemCountEx 宏。 有关详细信息,请参阅 虚拟List-View样式

如果创建列表视图控件时没有 LVS_OWNERDATA 样式,则发送此消息会导致控件为指定数量的项分配其内部数据结构。 这样,控件就不必在每次添加项时分配数据结构。

如果创建列表视图控件时使用 LVS_OWNERDATA 样式 (虚拟列表视图) ,则发送此消息将设置控件包含的虚拟项数。

lParam 参数仅适用于使用LVS_OWNERDATA和LVS_REPORTLVS_LIST样式的列表视图控件。

当通用控件列表视图是虚拟化列表视图 (LVS_OWNERDATA) 时,列表视图的项限制为 100,000,000。 在此方案中,当 wParam 为 100,000,001 时,LVM_SETITEMCOUNT将返回 FALSE。

要求

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