描述
在列表视图控件中插入新项.您可以使用此功能或明确的把LVM_INSERTITEM消息.
FreeBASIC 语法
#define ListView_InsertItem(hwnd, pitem) |
参数
hwndLV |
[in]句柄ListView控件. |
pitem |
[in]指向一个LVITEM结构指定列表视图项的属性.使用成员指定项的下标,新项目应插入.如果这个值是大于物品数量目前包含的ListView控件,新的项目将被附加到列表的结尾并分配正确的指标.检查返回值以确定分配给该项的实际索引. |
返回值
如果成功返回新项目的索引,否则为1.
备注
你不能用ListView_InsertItem或LVM_INSERTITEM插入子项.该LVITEM结构iSubItem成员须为零.看到有关设置子项信息LVM_SETITEM.
如果一个列表视图控件中有LVS_EX_CHECKBOXES样式集,任何价值15的LVITEM结构state成员放在12位将被忽略.当此样式集添加项时,它将始终设置为未选中状态.
如果一个列表视图控件中有LVS_SORTASCENDING或LVS_SORTDESCENDING窗口风格,一个LVM_INSERTITEM消息如果你试图插入一项具有LPSTR_TEXTCALLBACK作为其LVITEM结构pszText成员失败.
的ListView_InsertItem功能将新项目中的排序顺序中的适当位置,如果以下条件成立：
| · | You are using one of the LVS_SORTXXX styles. |
| · | You are not using the LVS_OWNERDRAW style. |
| · | The pszText member of the structure pointed to by pitem is not set to LPSTR_TEXTCALLBACK. |
引用文件
CommCtrl.bi