LVM_INSERTITEM
A version of this page is also available for
4/8/2010
This message inserts a new item in a list-view control. You can send this message explicitly or by using the ListView_InsertItem macro.
Syntax
LVM_INSERTITEM wParam = 0;
lParam = (LPARAM)(const LVITEM FAR *) pitem;
Parameters
- wParam
Not used.
pitem
Pointer to an LVITEM structure that specifies the attributes of the list-view item. The iItem member specifies the index of the new item.You cannot use ListView_InsertItem or LVM_INSERTITEM to insert subitems; the iSubItem member of the LVITEM structure must be zero.
Return Value
The index of the new item indicates success. -1 indicates failure.
Remarks
Related macro: ListView_InsertItem
Requirements
| Header | commctrl.h |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |