###User Defined Function###
_GUICtrlListView_InsertItem

###Description###
Inserts a new item in the control

###Syntax###
#include <GuiListView.au3>
_GUICtrlListView_InsertItem ( $hWnd, $sText [, $iIndex = -1 [, $iImage = -1 [, $iParam = 0]]] )


###Parameters###
@@ParamTable@@
$hWnd
	Control ID/Handle to the control
$sText
	Item text. If set to -1, the item text is set via the $LVN_GETDISPINFO notification message.
$iIndex
	[optional] 0-based index at which the new item should be inserted.
	If this value is greater than the number of items currently contained by the control, the new item will be appended to the end of the list and assigned the correct index.
$iImage
	[optional] 0-based index of the item's icon in the control's image list
$iParam
	[optional] Application Defined Data
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	the index of the new item.
Failure:	-1.
@@End@@


###Remarks###
You can not use this function to insert subitems. Use <a href="_GUICtrlListView_SetItemText.htm">_GUICtrlListView_SetItemText()</a> to insert subitems.


###Related###
_GUICtrlListView_SetItemText


###Example###
@@IncludeExample@@
