сообщение LVM_SETITEMCOUNT

Статья
05/12/2022
Чтение занимает 2 мин

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

Параметры

wParam

Количество элементов, содержащихся в элементе управления "Представление списка".

lParam

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

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

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

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

Remarks

Выделение памяти зависит от того, как был создан элемент управления представления списка. Это сообщение можно отправить явно или использовать макросы 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 [только классические приложения]
Header	Commctrl.h