ListView_InsertItem

This macro inserts a new item in a list view control. You can use this macro or send the LVM_INSERTITEM message explicitly.

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.

Related message: LVM_INSERTITEM

Requirements

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.