CB_INITSTORAGE сообщение

  • Статья

Приложение отправляет сообщение CB_INITSTORAGE перед добавлением большого количества элементов в часть списка поля со списком. Это сообщение выделяет память для хранения элементов списка.

Параметры

wParam

Количество добавляемых элементов.

lParam

Объем памяти, выделяемый для строк элементов , в байтах.

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

Если сообщение выполнено успешно, возвращаемым значением является общее количество элементов, для которых была предварительно выделена память, то есть общее количество элементов, добавленных всеми успешными CB_INITSTORAGE сообщений.

Если сообщение завершается ошибкой, возвращается значение CB_ERRSPACE.

Сообщение выделяет память и возвращает значения успешного выполнения и ошибки, описанные выше.

Комментарии

Сообщение CB_INITSTORAGE помогает ускорить инициализацию полей со списком с большим количеством элементов (более 100). Он резервирует указанный объем памяти, чтобы последующие CB_ADDSTRING, CB_INSERTSTRING и CB_DIR сообщения занимают самое короткое время. Вы можете использовать оценки для параметров wParam и lParam . Если вы переоценили, выделяется дополнительная память, а если вы недооцениваете, то обычное выделение используется для элементов, превышающих запрошенный объем.

Требования

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

См. также раздел

Справочные материалы

CB_ADDSTRING

CB_DIR

CB_INSERTSTRING