CListCtrl::InsertItem

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_TEXT CALLBACK。要了解更多有关回调项的信息，请参阅CListCtrl::GetCall backMask.
nImage	项图象的索引值，或当项为回调项时，该变量为I_IMAGECALLBACK。要了解更多有关回调项的信息，请参阅CListCtrl::GetCallbackMask
nMask	参数nMask指定了哪个项属性作为参数传递是有效的。它可以是联机文档“平台SDK” 中LVITEM结构所描述的一个或多个掩码值。有效的数据能够通过位与运算来组合。
nState	指示项的状态、状态图象及轮廓图象。请参阅联机文档“平台SDK”中的LVITEM来获取更多信息，并参阅有效标志列表中的列表视图项状态。
nStateMask	指示状态成员中的哪一位将被获取或修改。请参阅联机文档“平台SDK”中的LVITEM来获取更多信息。
nImage	图象列表之内项的图象的索引。
lParam	与项相关联的应用指定的32位值。如果该参数被指定，那么必须设置nMask的属性为LVIF_PARAM。

说明：向列表视图控件中新插入一项。

请参阅：CListCtrl::DeleteItem, CListCtrl::DeleteAllItems