Function Reference

_GUICtrlListViewGetItemText

Retrieves some or all of a list-view item

#Include <GuiListView.au3>
_GUICtrlListViewGetItemText($h_listview[, $i_Item=-1[, $i_SubItem=-1]])

 

Parameters

$h_listview control id/control hWnd
$i_Item Index of item to retrieve from (zero-based index)
$i_SubItem Optional: Column of item to retrieve from (zero-based index)

 

Return Value

If $i_Item = -1 then current selected index is used
If $i_SubItem = -1 then row is returned pipe delimited
else text from $i_SubItem position is returned
If error then @error is set to $LV_ERR and "" is returned

 

Remarks

None.

 

Related

_GUICtrlListViewGetItemTextArray, _GUICtrlListViewGetCurSel, _GUICtrlListViewGetSelectedCount

 

Example


#include <GuiConstants.au3>
#include <GuiListView.au3>
 
Opt ('MustDeclareVars', 1)
Dim $listview, $Btn_Get, $Btn_GetSelected, $Btn_Exit, $msg, $Status, $ret
GUICreate("ListView Get Item Text", 392, 322)

$listview = GUICtrlCreateListView("col1|col2|col3", 40, 30, 310, 149)
GUICtrlCreateListViewItem("line1|data1|more1", $listview)
GUICtrlCreateListViewItem("line2|data2|more2", $listview)
GUICtrlCreateListViewItem("line3|data3|more3", $listview)
GUICtrlCreateListViewItem("line4|data4|more4", $listview)
GUICtrlCreateListViewItem("line5|data5|more5", $listview)
$Btn_Get = GUICtrlCreateButton("Get From Index 2", 75, 200, 90, 40)
$Btn_GetSelected = GUICtrlCreateButton("Get Selected", 200, 200, 90, 40)
$Btn_Exit = GUICtrlCreateButton("Exit", 300, 260, 70, 30)
$Status = GUICtrlCreateLabel("", 0, 302, 392, 20, BitOR($SS_SUNKEN, $SS_CENTER))

GUISetState()
While 1
    $msg = GUIGetMsg()
    Select
        Case $msg = $GUI_EVENT_CLOSE Or $msg = $Btn_Exit
            ExitLoop
        Case $msg = $Btn_Get
            GUICtrlSetData($Status, "")
            MsgBox(0, "Passed Item Index only", _GUICtrlListViewGetItemText ($listview, 2))
            MsgBox(0, "Passed Item Index, SubItem 0", _GUICtrlListViewGetItemText ($listview, 2, 0))
        Case $msg = $Btn_GetSelected
            GUICtrlSetData($Status, "")
            $ret = _GUICtrlListViewGetItemText ($listview)
            If ($ret <> $LV_ERR) Then
                MsgBox(0, "Selected Item", $ret)
                $ret = _GUICtrlListViewGetItemText ($listview, -1, 0)
                If ($ret <> $LV_ERR) Then
                    MsgBox(0, "Selected Item, SubItem 0", $ret)
                EndIf
            Else
                GUICtrlSetData($Status, "Nothing Selected")
            EndIf
    EndSelect
WEnd
Exit