IResultData：：SetItemCount 方法 (mmc.h)

IResultData：：SetItemCount 方法设置虚拟列表中的项数。

语法

HRESULT SetItemCount(
  [in] int   nItemCount,
  [in] DWORD dwOptions
);

parameters

[in] nItemCount

控件将包含的项数。

[in] dwOptions

以下标志的组合：

MMCLV_UPDATE_NOINVALIDATEALL

仅重绘结果窗格底部添加或删除的项。 仅当在列表底部删除或添加项时，才设置此标志。

MMCLV_UPDATE_NOSCROLL

不要调整更改的项计数的滚动条。

返回值

此方法可以返回其中一个值。

注解

SetItemCount 方法的主要用途是填充虚拟列表。 由于实际上未将项添加到虚拟列表中，因此这是通知列表存在多少个虚拟项的方法。

注意 在列表中间添加或删除项时，不要设置MMCLV_UPDATE_NOINVALIDATEALL标志;也就是说，当需要重新编制现有项的索引时。 如果在列表中间添加或删除项，则设置 标志会生成列表的错误更新。

 

在仅从虚拟列表末尾添加和删除并且希望减少重绘量的情况下，应使用 MMCLV_UPDATE_NOINVALIDATEALL 标志。 如果设置此标志，MMC 仅对添加到结果窗格的新项调用 IComponent：：GetDisplayInfo 。 设置标志会告知 MMC 不会对任何项进行重新编号。 MMC 仅重绘添加或删除的可见项。

也可以为非虚拟列表调用 SetItemCount，但用途不同。 当为非虚拟列表调用时，SetItemCount 会预先分配指定数量的项的内存。 添加大量项时，这可以通过减少列表必须进行的内存分配调用数来提高性能。

要求

最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	mmc.h
DLL	Mmcndmgr.dll

另请参阅

IResultData

IResultData2

IResultOwnerData