↑  ←  Описание функции

_GUICtrlListBox_AddString

Добавляет пункт

#include <GuiListBox.au3>
_GUICtrlListBox_AddString($hWnd, $sText)

Параметры

$hWnd Дескриптор или идентификатор элемента
$sText Добавляемый пункт

Возвращаемое значение

Успех:Возвращает индекс пункта, отсчёт от 0
Ошибка:Возвращает -1

Примечания

Если недостаточно места для вмещения новой строки, то возвращается значение $LB_ERRSPACE.

Если ListBox не имеет стиль $LBS_SORT, то строка добавляется в конец списка. Иначе, строка добавляется в список и он сортируется.

См. также

_GUICtrlListBox_InsertString, _GUICtrlListBox_DeleteString, _GUICtrlListBox_AddFile, _GUICtrlListBox_InitStorage

Пример

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

$Debug_LB = False ; Проверяет ClassName передаваемый в ListBox функции. Установите True и используйте дескриптор от другого элемента, чтобы увидеть как это работает

_Main()

Func _Main()
    Local $hListBox

    ; Создаёт GUI
    GUICreate("Добавляет строку в ListBox", 400, 296)
    $hListBox = GUICtrlCreateList("", 2, 2, 396, 296, BitOR($WS_BORDER, $WS_VSCROLL, $LBS_NOTIFY, $LBS_DISABLENOSCROLL, $WS_HSCROLL))

    GUISetState()

    ; Добавляет строки
    _GUICtrlListBox_BeginUpdate($hListBox)
    For $iI = 1 To 9
        _GUICtrlListBox_AddString($hListBox, StringFormat("%03d : Рандомная строка", Random(1, 100, 1)))
    Next
    _GUICtrlListBox_InsertString($hListBox, "--- Вставлена в позицию 3 ---", 3)
    _GUICtrlListBox_InsertString($hListBox, "Строка вставлена в позицию 6", 6)
    _GUICtrlListBox_InsertString($hListBox, "Давайте добавим одну длинную строку текста, чтобы получить горизонтальную " & _
        "полосу прокрутки и показать, что, если не обновить полосу прокрутки, то не будет возможности увидеть всю строку.", 9)
    _GUICtrlListBox_UpdateHScroll($hListBox)
    _GUICtrlListBox_EndUpdate($hListBox)

    ; Цикл выполняется, пока окно не будет закрыто
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>_Main