LVM_INSERTITEM

  • Article

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

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 Values

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

Remarks

Related macro: ListView_InsertItem

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Commctrl.h.

See Also

LVITEM | List-View Controls Messages

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.