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


_GUICtrlListView_InsertItem

Вставляет новый пункт в ListView

#include <GuiListView.au3>
_GUICtrlListView_InsertItem($hWnd, $sText [, $iIndex = -1 [, $iImage = -1 [, $iParam = 0]]])

Параметры

$hWnd Дескриптор или идентификатор элемента
$sText Текст пункта. Если установлено значение -1, то текст пункта устанавливается с помощью уведомления $LVN_GETDISPINFO.
$iIndex [необязательный] Индекс, в позицию которого вставляется новый пункт. Если это значение больше, чем количество пунктов в ListView, то новый пункт будет добавлен в конец списка с присвоением соответствующего индекса.
$iImage [необязательный] Индекс иконки в списке изображений, отсчёт от 0
$iParam [необязательный] Данные определяемые приложением (число). Смотрите также _GUICtrlListView_GetItemParam

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

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

Примечания

Вы не можете использовать эту функцию для вставки подпунктов. Используйте _GUICtrlListView_SetItemText для вставки подпунктов.

См. также

_GUICtrlListView_SetItemText

Пример

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

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

_Main()

Func _Main()
    Local $hListView

    GUICreate("ListView - Вставляет пункт", 400, 300)
    $hListView = GUICtrlCreateListView("", 2, 2, 394, 268)
    GUISetState()

    ; Вставляет колонку
    _GUICtrlListView_InsertColumn($hListView, 0, "Колонка 1", 100)

    ; Добавляет пункты
    _GUICtrlListView_InsertItem($hListView, "Пункт 1", 0)
    _GUICtrlListView_InsertItem($hListView, "Пункт 2", 1)
    _GUICtrlListView_InsertItem($hListView, "Пункт 3", 1)

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