ListView_InsertItem  K_HDHE 

The ListView_InsertItem macro inserts a new item in a list view control. You can use this macro or explicitly send the LVM_INSERTITEM1NXJX0F message.

int ListView_InsertItem(

Parameters

hwnd

Handle to the list view control.

pitem

Pointer to an LV_ITEM3F10CR 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_INSERTITEM1NXJX0F to insert subitems; the iSubItem member of the LV_ITEM structure must be zero.

Return Values

Returns the index of the new item if successful or -1 otherwise.

Remarks

If a list view control has either the LVS_SORTASCENDING or LVS_SORTDESCENDING window style, an LVM_INSERTITEM message will fail if you try to insert an item that has LPSTR_TEXTCALLBACK as the pszText member of its LV_ITEM structure.

See Also