Visual C++. Описание стандартных классов - AddString

ОГЛАВЛЕНИЕ


AddString

int AddString(LPCTSTR lpszItem);

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

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

Аргументы

  • lpszItem - указатель на строку символов, заканчивающуюся нулем, которую необходимо добавить в список.

Описание

Данная функция вызывается для добавления строки в окно списка. Если данное окно списка не имеет стиля LBS_SORT, то строка добавляется в конец списка. В противном случае, строка добавляется в список и после этого список сортируется. Если данное окно списка имеет стиль LBS_SORT, но не имеет стиля LBS_HASSTRINGS, приложение сортирует список, используя вызовы функции CompareItem. Чтобы добавить строку в определенное место в списке, используйте функцию InsertString.