_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