This macro inserts a new item in a list view control. You can use this macro or send the LVM_INSERTITEM message explicitly.
At a Glance
| Header file: | Commctrl.h |
| Windows CE versions: | 1.0 and later |
| Related message: | LVM_INSERTITEM |
Syntax
int ListView_InsertItem( HWND hwnd, const LV_ITEM FAR* pitem );
Parameters
hwnd
Handle to the list view control.
pitem
Pointer to an LVITEM structure that specifies the attributes of the list view item. The iItem member of the structure 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 Values
The index of the new item indicates success. 1 indicates failure.
Remarks
If a list view control has either the LVS_SORTASCENDING or LVS_SORTDESCENDING window style, an LVM_INNSETITEM message will fail if you try to insert an item that has LPSTR_TEXTCALLBACK as the pszText member of its LVITEM structure.