сообщение CB_ADDSTRING

  • Статья

Добавляет строку в поле списка поля со списком. Если поле со списком не имеет стиля CBS_SORT , строка добавляется в конец списка. В противном случае строка вставляется в список, а список сортируется.

Параметры

wParam

Этот параметр не используется.

lParam

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

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

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

Комментарии

Если вы создаете поле со списком, нарисованное владельцем, со стилем CBS_SORT , но без стиля CBS_HASSTRINGS , сообщение WM_COMPAREITEM отправляется владельцу поля со списком один или несколько раз, чтобы новый элемент можно было правильно разместить в списке.

Чтобы вставить строку в определенном расположении в списке, используйте сообщение CB_INSERTSTRING .

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

Comclt32.dll версии 5.0 или более поздней: Если задано CBS_LOWERCASE или CBS_UPPERCASE , версия юникода CB_ADDSTRING изменяет строку. Если используется глобальная память только для чтения, это приводит к сбою приложения.

Требования

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

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

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

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM