Set the focus rectangle to the item at the specified index in a multiple-selection list box
#include <GuiListBox.au3>
_GUICtrlListBox_SetCaretIndex ( $hWnd, $iIndex [, $bPartial = False] )
| $hWnd | Control ID/Handle to the control |
| $iIndex | Specifies the 0-based index of the item |
| $bPartial | [optional] If False, the item is scrolled until it is fully visible. If it is True, the item is scrolled until it is at least partially visible. |
| Success: | True. |
| Failure: | False. |
#include <GUIConstantsEx.au3>
#include <GuiListBox.au3>
Example()
Func Example()
; Create GUI
GUICreate("List Box Get/Set Caret Index (v" & @AutoItVersion & ")", 400, 296)
Local $idListBox = GUICtrlCreateList("", 2, 2, 396, 296)
GUISetState(@SW_SHOW)
; Add strings
_GUICtrlListBox_BeginUpdate($idListBox)
For $iI = 0 To 9
_GUICtrlListBox_AddString($idListBox, StringFormat("%03d : Random string", $iI))
Next
_GUICtrlListBox_EndUpdate($idListBox)
; Set caret index
_GUICtrlListBox_SetCaretIndex($idListBox, 2)
; Read caret index
Local $iIndex = _GUICtrlListBox_GetCaretIndex($idListBox)
_GUICtrlListBox_SetCurSel($idListBox, $iIndex)
; Loop until the user exits.
Do
Until GUIGetMsg() = $GUI_EVENT_CLOSE
GUIDelete()
EndFunc ;==>Example