int InsertItem ( const LVITEM * pItem );
int InsertItem (int nItem, LPCTSTR lpszItem );
int InsertItem (int nItem, LPCTSTR lpszItem, int nImage );
int InsertItem (UINT nMask, int nItem, LPCTSTR lpszItem, UINT nState, UINT nStateMask, int nImage, LPARAM lParam );
Возвращаемое значение
Индекс нового элемента в случае успеха или иначе -1.
Параметры
pItem
Указатель на LVITEM структура, которая задает атрибуты элемента, как описано в Пакете SDK платформы.
nItem
Индекс элемента для вставки.
lpszItem
Адрес строки, содержащей метку элемента или LPSTR_TEXTCALLBACK , если элемент является элементом обратного вызова. Информация по пунктам обратного вызова см. в CListCtrl::GetCallbackMask.
nImage
Индекс элемента изображения, или I_IMAGECALLBACK если элемент является элементом обратного вызова. Информация по пунктам обратного вызова см. в CListCtrl::GetCallbackMask.
nMask
Параметр nMask определяет, какой элемент передавать в качестве параметров атрибуты являются действительными. Это может быть один или несколько из маски значений, описанных в LVITEM структуры в Platform SDK. Допустимые значения могут быть объединены с побитовый оператор OR.
nState
Указывает состояние элемента, изображение состояния и накладываемого изображения. Разделах Platform SDK LVITEM для получения дополнительной информации и Состояний элемента представления списка для получения списка допустимых флагов.
nStateMask
Показывает, какие биты государства-члена будут извлечены или изменен. См LVITEM в Platform SDK для получения дополнительной информации.
nImage
Индекс элемента в изображения в списке изображений.
lParam
32-Разрядное значение приложения связанного с пунктом. Если указан этот параметр, необходимо задать атрибуту nMask LVIF_PARAM.
Примечания
Вставляет элемент в элементе управления списка.
Обзор CListCtrl | Члены класса | Иерархическая схема
См. также CListCtrl::DeleteItem, CListCtrl::DeleteAllItems