Function Reference


_GUICtrlListView_GetItemEx

Retrieves some or all of an item's attributes

#include <GuiListView.au3>
_GUICtrlListView_GetItemEx ( $hWnd, ByRef $tItem )

Parameters

$hWnd Control ID/Handle to the control
$tItem $tagLVITEM structure that specifies the information to retrieve

Return Value

Success: True.
Failure: False.

Related

$tagLVITEM, _GUICtrlListView_GetItem

Example

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

Example()

Func Example()
    GUICreate("ListView Get/Set Item Ex (v" & @AutoItVersion & ")S", 400, 300)
    Local $idListview = GUICtrlCreateListView("", 2, 2, 394, 268)
    GUISetState(@SW_SHOW)

    ; Set ANSI format
;~     _GUICtrlListView_SetUnicodeFormat($idListview, False)

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

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

    ; Show item 1 raw state
    Local $tItem = DllStructCreate($tagLVITEM)
    DllStructSetData($tItem, "Mask", $LVIF_STATE)
    DllStructSetData($tItem, "Item", 1)
    DllStructSetData($tItem, "StateMask", -1)
    _GUICtrlListView_GetItemEx($idListview, $tItem)
    MsgBox($MB_SYSTEMMODAL, "Information", "Item 1 State: " & DllStructGetData($tItem, "State"))

    ; Change item 1
    MsgBox($MB_SYSTEMMODAL, "Information", "Changing item 1")
    Local $tText
    If _GUICtrlListView_GetUnicodeFormat($idListview) Then
        $tText = DllStructCreate("wchar Text[11]")
    Else
        $tText = DllStructCreate("char Text[11]")
    EndIf
    $tItem = DllStructCreate($tagLVITEM)
    DllStructSetData($tText, "Text", "New Item 1")
    DllStructSetData($tItem, "Mask", $LVIF_TEXT)
    DllStructSetData($tItem, "Item", 1)
    DllStructSetData($tItem, "Text", DllStructGetPtr($tText))
    _GUICtrlListView_SetItemEx($idListview, $tItem)

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