ListView_InsertItem

【勇芳软件工作室】汉化HomePreviousNext

ListView_InsertItem宏会在列表视图控件中插入一个新项目。您可以使用此宏或显式发送LVM_INSERTITEM消息。

int ListView_InsertItem(

HWND【HWND】, 
const LV_ITEM FAR *【Pitm】 
); 

参数

【HWND】

处理列表视图控件。

【Pitm】

指向LV_ITEM结构的指针,指定列表视图项的属性。的iItem成员指定新项目的索引。

您不能使用ListView_InsertItemLVM_INSERTITEM插入子项; LV_ITEM结构的iSubItem成员必须为零。

返回值

如果成功返回新项目的索引,否则返回-1。

备注

如果列表视图控件具有LVS_SORTASCENDING或LVS_SORTDESCENDING窗口样式,则如果尝试将具有LPSTR_TEXTCALLBACK的项目作为其LV_ITEM结构的pszText成员插入,则LVM_INSERTITEM消息将失败。

也可以看看

LV_ITEM, LVM_INSERTITEM