ListView_SetItemCount macro (commctrl.h)

Causes the list-view control to allocate memory for the specified number of items. You can use this macro or send the LVM_SETITEMCOUNT message explicitly.

Syntax

void ListView_SetItemCount(
   hwndLV,
   cItems
);

Parameters

hwndLV

Type: HWND

A handle to a list-view control.

cItems

Type: int

The number of items for which the list-view control should allocate memory.

Return value

None

Remarks

If the list-view control was created without the LVS_OWNERDATA style, this macro causes the control to allocate its internal data structures for the specified number of items. This prevents the control from having to allocate the data structures every time an item is added.

If the list-view control was created with the LVS_OWNERDATA style (a virtual list view), the ListView_SetItemCountEx macro should be used.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header commctrl.h