Function Reference


Sets some or all of a item's attributes

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


$hWnd Control ID/Handle to the control
$sText Item text. See remark.
$iIndex [optional] The 0-based index of the item
$iSubItem [optional] 1-based index of the subitem or zero if this refers to an item
$iImage [optional] 0-base index of the item's icon in the control's image list
$iParam [optional] Value specific to the item
$iIndent [optional] Number of image widths to indent the item. A single indentation equals the width of an image.

Return Value

Success: True.
Failure: False.


If a notification callback is needed, you have to specify $sText = -1 (LPSTR_TEXTCALLBACK).

As AutoIt uses the $iParam parameter to store the controlID of native-created ListView items, this value should be set sufficiently high for UDF-created items to avoid possible conflict with any existing controls - a starting value of 1000 is recommended.


_GUICtrlListView_GetItem, _GUICtrlListView_SetItemEx


#include <GUIConstantsEx.au3>
#include <GuiListView.au3>
#include <MsgBoxConstants.au3>


Func Example()
    Local $idListview

    GUICreate("ListView Set Item", 400, 300)
    $idListview = GUICtrlCreateListView("", 2, 2, 394, 268)

    ; Add columns
    _GUICtrlListView_AddColumn($idListview, "Items", 100)

    ; Add items
    GUICtrlCreateListViewItem("Item 1", $idListview)
    GUICtrlCreateListViewItem("Item 2", $idListview)
    GUICtrlCreateListViewItem("Item 3", $idListview)

    ; Change item 2
    MsgBox($MB_SYSTEMMODAL, "Information", "Changing item 2")
    _GUICtrlListView_SetItem($idListview, "New Item 2", 1)

    ; Loop until the user exits.
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Example