Function Reference


_GUICtrlListView_SetHotItem

Sets the hot item

#include <GuiListView.au3>
_GUICtrlListView_SetHotItem($hWnd, $iIndex)

Parameters

$hWnd Control ID/Handle to the control
$iIndex Zero-based index of the item to be set as the hot item

Return Value

Success: Index of the item that was previously hot
Failure: -1

Remarks

None.

Related

_GUICtrlListView_GetHotItem

Example


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

$Debug_LV = False ; Check ClassName being passed to ListView functions, set to True and use a handle to another control to see it work

_Main()

Func _Main()
    Local $exStyles = BitOR($LVS_EX_FULLROWSELECT, $LVS_EX_GRIDLINES), $hListView

    GUICreate("ListView Set Hot Item", 400, 300)

    $hListView = GUICtrlCreateListView("", 2, 2, 394, 268)
    $hListView = GUICtrlGetHandle($hListView)
    _GUICtrlListView_SetExtendedListViewStyle($hListView, $exStyles)
    GUISetState()

    ; Add columns
    _GUICtrlListView_AddColumn($hListView, "Column 1", 100)
    _GUICtrlListView_AddColumn($hListView, "Column 2", 100)
    _GUICtrlListView_AddColumn($hListView, "Column 3", 100)

    ; Add items
    _GUICtrlListView_AddItem($hListView, "Row 1: Col 1")
    _GUICtrlListView_AddSubItem($hListView, 0, "Row 1: Col 2", 1)
    _GUICtrlListView_AddSubItem($hListView, 0, "Row 1: Col 3", 2)
    _GUICtrlListView_AddItem($hListView, "Row 2: Col 1")
    _GUICtrlListView_AddSubItem($hListView, 1, "Row 2: Col 2", 1)
    _GUICtrlListView_AddItem($hListView, "Row 3: Col 1")

    ; Set hot item
    _GUICtrlListView_SetHotItem($hListView, 1)
    MsgBox(4160, "Information", "Hot Item: " & _GUICtrlListView_GetHotItem($hListView))

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