函数参考


_GUICtrlListView_InsertItem

插入项目

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

参数

$hWnd 控件句柄
$sText 项目文本. 如设为 -1, 则项目文本通过 $LVN_GETDISPINFO 通知消息设置.
$iIndex [可选参数] 插入项目的 0 基索引.
如果这个值大于目前控件所含的项目数量,
项目追加到列表末尾,并指派正确的索引
$iImage [可选参数] 项目图标在图像列表中的 0 基索引
$iParam [可选参数] 应用程序定义的数据

返回值

成功: 返回新项目索引
失败: 返回 -1

注意/说明

 不能使用此函数插入子项. 插入子项使用 _GUICtrlListView_SetItemText 函数.

相关

_GUICtrlListView_SetItemText

示例/演示


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

$Debug_LV = False ; 检查传递给 ListView 函数的类名, 设置为True并输出到一个控件的句柄,用于检查它是否工作

_Main()

Func _Main()
    Local $hListView

    GUICreate("ListView Insert Item", 400, 300)
    $hListView = GUICtrlCreateListView("", 2, 2, 394, 268)
    GUISetState()

    ; Insert columns
    _GUICtrlListView_InsertColumn($hListView, 0, "Column 1", 100)

    ; 添加项目
    _GUICtrlListView_InsertItem($hListView, "Item 1", 0)
    _GUICtrlListView_InsertItem($hListView, "Item 2", 1)
    _GUICtrlListView_InsertItem($hListView, "Item 3", 1)

    ; 循环直到用户退出
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>_Main