ListView_SetItemCount macro (commctrl.h)

Article
10/21/2024

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(
   HWND hwndLV,
   int  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

Share via