Поделиться через


LVM_SETITEMCOUNT сообщение

Заставляет элемент управления представлением списка выделять память для указанного количества элементов или задает виртуальное количество элементов в виртуальном элементе управления представления списка.

Параметры

wParam

Количество элементов, которые в конечном итоге будет содержать элемент управления представлением списка.

lParam

Версия 4.70. Значения, определяющие поведение элемента управления представлением списка после сброса количества элементов. Это значение может быть комбинацией следующих:

Значение Значение
LVSICF_NOINVALIDATEALL
Элемент управления представлением списка не будет перекрашить, если только затронутые элементы не находятся в представлении.
LVSICF_NOSCROLL
Элемент управления представлением списка не изменяет позицию прокрутки при изменении количества элементов.

Возвращаемое значение

Возвращает ненулевое значение в случае успешного выполнения или ноль в противном случае.

Комментарии

Способ выделения памяти зависит от того, как был создан элемент управления представлением списка. Это сообщение можно отправить явно или использовать макросы ListView_SetItemCount или ListView_SetItemCountEx . Дополнительные сведения см. в статье Стиль виртуальной List-View.

Если элемент управления представлением списка был создан без стиля LVS_OWNERDATA , отправка этого сообщения приведет к выделению внутренних структур данных для указанного количества элементов. Это не позволяет элементу управления выделять структуры данных при каждом добавлении элемента.

Если элемент управления представлением списка был создан в стиле LVS_OWNERDATA (виртуальное представление списка), отправка этого сообщения задает виртуальное количество элементов, содержащихся в элементе управления.

Параметр lParam предназначен только для элементов управления представлением списка, использующих стили LVS_OWNERDATA и LVS_REPORT или LVS_LIST .

Если общее представление списка элементов управления является виртуализированным представлением списка (LVS_OWNERDATA), в представлении списка существует ограничение в 100 000 000 элементов. В этом сценарии LVM_SETITEMCOUNT возвращает значение FALSE, если имеет значение wParam 100 000 001.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2003 [только классические приложения]
Заголовок
Commctrl.h