LVM_INSERTITEM

This message inserts a new item in a list view control. You can send this message explicitly or by using the ListView_InsertItem macro.

At a Glance

Header file: Commctrl.h
Windows CE versions: 1.0 and later
Related macro: ListView_InsertItem

Syntax

LVM_INSERTITEM wParam = 0;
lParam = (LPARAM)(const LV_ITEM FAR *) pitem;

Parameters

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 Values

The index of the new item indicates success. -1 indicates failure.

See Also

LV_ITEM