сообщение CB_INSERTSTRING

Вставляет данные строки или элемента в список поля со списком. В отличие от сообщения CB_ADDSTRING , CB_INSERTSTRING сообщение не приводит к сортировке списка со стилем CBS_SORT .

Параметры

wParam

Отсчитываемый от нуля индекс позиции, в которую вставляется строка. Если этот параметр имеет значение -1, строка добавляется в конец списка.

lParam

Указатель на строку, завершаемую нулевым значением, которая должна быть вставлена. Если вы создаете поле со списком со стилем, нарисованным владельцем, но без стиля CBS_HASSTRINGS , значение параметра lParam сохраняется, а не строка, на которую он указывал бы в противном случае.

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

Возвращаемое значение — это индекс позиции, в которую была вставлена строка. При возникновении ошибки возвращаемое значение будет CB_ERR. Если для хранения новой строки недостаточно места, она CB_ERRSPACE.

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

Требования

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

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

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

CB_ADDSTRING

LB_SETHORIZONTALEXTENT

CB_DIR