LVM_INSERTITEM


		Contents Index Topic Contents
	Previous Topic: LVM_INSERTCOLUMN Next Topic: LVM_REDRAWITEMS

LVM_INSERTITEM
LVM_INSERTITEM 
    wParam = 0; 
    lParam = (LPARAM) (const LPLVITEM) pitem; 
Inserts a new item in a list view control. You can send this message explicitly or by using the ListView_InsertItem macro.
Returns the index of the new item if successful, or -1 otherwise.

pitem
Address of 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.

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 LVITEM structure.

Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.