描述
在列表视图控件中插入一个新项目。
PB语法
FUNCTION ListView_InsertItem( _ BYVAL hwndLV AS DWORD, _ BYREF pitem AS LVITEM _ ) AS LONG |
参数
hwndLV |
[in]处理ListView控件。 |
pitem |
[in]指向LVITEM结构的指针，用于指定列表视图项的属性。 |
返回值
如果成功，返回新项目的索引，否则返回-1。
备注
您不能使用ListView_InsertItem或LVM_INSERTITEM插入子项。
如果列表视图控件具有LVS_EX_CHECKBOXES样式集，则将忽略位于LVITEM结构的state成员的位12到15中的任何值。
如果列表视图控件具有LVS_SORTASCENDING或LVS_SORTDESCENDING窗口样式，则如果尝试将具有LPSTR_TEXTCALLBACK的项目作为其LVITEM结构的pszText成员插入，则LVM_INSERTITEM消息将失败。
如果满足以下条件，则ListView_InsertItem功能将以排序顺序将新项目插入正确的位置：
| · | 您正在使用LVS_SORTXXX样式之一。 |
| · | 您没有使用LVS_OWNERDRAW样式。 |
| · | pitem指向的结构的pszText成员未设置为LPSTR_TEXTCALLBACK。 |
最低操作系统
Windows NT 3.51，Windows 95。
引用文件 #INCLUDE Once
ListViewCtrl.inc