IResultData：：SetItemCount 方法 (mmc.h)

IResultData：：SetItemCount方法會設定虛擬清單中的專案數目。

語法

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

參數

[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