ListView_InsertItem宏（commctrl.h）

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

语法

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

hwnd

类型：HWND

列表视图控件的句柄。

pitem

类型：const LPLVITEM

指向 LVITEM 结构的指针，该结构指定列表视图项的属性。使用 iItem 成员指定应插入新项的从零开始的索引。如果此值大于 listview 控件当前包含的项数，则新项将追加到列表末尾并分配正确的索引。检查宏的返回值，以确定分配给该项的实际索引。

类型：int

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

不能使用 ListView_InsertItem 或 LVM_INSERTITEM 插入子项。 LVITEM 结构的 iSubItem 成员必须为零。有关设置子项的信息，请参阅 LVM_SETITEM。

如果列表视图控件设置了 LVS_EX_CHECKBOXES 样式，则会忽略 LVITEM 结构成员状态位 12 到 15 位的任何值。添加具有此样式集的项时，将始终将其设置为未选中状态。

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

如果满足以下条件，ListView_InsertItem 宏将新项插入排序顺序中的正确位置：