Function Reference


Creates a ListView item.

GUICtrlCreateListViewItem ( "text", listviewID )


text subitemtext separated with Opt("GUIDataSeparatorChar").
listviewID controlID of the ListView control holding the item.

Return Value

Success: the identifier (controlID) of the new control.
Failure: 0.


This function creates the individual ListView items that can be selected. The items function as normal controls and can be set with GUICtrlSetData().
Items can be deleted as with any other control by using GUICtrlDelete().
ListView items can be dragged and drop into an Edit or Input control with a $GUI_DROPACCEPTED state.
See GUICtrlCreateListView() about resizing of the column.

The special flag $GUI_BKCOLOR_LV_ALTERNATE can be used with Listview control to give alternate background of the ListviewItems lines.
The odd lines will get the color set by GUICtrlSetBkColor() of the Listview control.
The even lines will get the color set by GUICtrlSetBkColor() of the ListviewItem control.

The above constants are defined in #include <GUIConstantsEx.au3>


GUICtrlCreateListView, GUICtrlDelete, GUICtrlRead, GUICtrlSetData, GUICtrlSetState, GUIDataSeparatorChar (Option), GUIGetMsg


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


Func Example()
        GUICreate("listview items", 220, 250, 100, 200, -1, $WS_EX_ACCEPTFILES)
        GUISetBkColor(0x00E0FFFF) ; will change background color

        Local $idListview = GUICtrlCreateListView("col1  |col2|col3  ", 10, 10, 200, 150) ;,$LVS_SORTDESCENDING)
        Local $idButton = GUICtrlCreateButton("Value?", 75, 170, 70, 20)
        Local $idItem1 = GUICtrlCreateListViewItem("item2|col22|col23", $idListview)
        Local $idItem2 = GUICtrlCreateListViewItem("item1|col12|col13", $idListview)
        Local $idItem3 = GUICtrlCreateListViewItem("item3|col32|col33", $idListview)
        GUICtrlCreateInput("", 20, 200, 150)
        GUICtrlSetState(-1, $GUI_DROPACCEPTED) ; to allow drag and dropping
        GUICtrlSetData($idItem2, "ITEM1")
        GUICtrlSetData($idItem3, "||COL33")

        ; Loop until the user exits.
        While 1
                Switch GUIGetMsg()
                        Case $GUI_EVENT_CLOSE

                        Case $idButton
                                MsgBox($MB_SYSTEMMODAL, "listview item", GUICtrlRead(GUICtrlRead($idListview)), 2)

                        Case $idListview
                                MsgBox($MB_SYSTEMMODAL, "listview", "clicked=" & GUICtrlGetState($idListview), 2)

EndFunc   ;==>Example