函数参考


GUICtrlCreateListViewItem

在GUI上创建一个 ListView 项目控件.

GUICtrlCreateListViewItem ( "文本", 列表视图ID )

参数

文本 子项目文本使用分隔符"|"分开,您可以使用 Opt("GUIDataSeparatorChar") 进行设置.
列表视图ID 当前列表视图(ListView)控件的控件标识.

返回值

成功: 返回新控件的控件标识(控件ID).
失败: 返回 0.

注意/说明

本函数用于创建一个可被选择的 ListView 项目,创建的项目和普通的控件一样可以使用 GUICtrlSetData 设置相关数据.
创建的项目也可以像其它控件一样使用 GUICtrlDelete 删除.
ListView 项目可拖放到设置了 $GUI_ACCEPTFILES 状态的编辑框或输入框控件上.
请查看 GUICtrlCreateListView 了解如何调整列的大小.

还有个特殊标志 $GUI_BKCOLOR_LV_ALTERNATE 用于设置 Listview 控件的列表视图项目行(ListviewItems)的交替背景色.
可以使用 GUICtrlSetBkColor 设置 Listview 控件背景颜色.
或者使用 GUICtrlSetBkColor 设置 ListviewItem 控件背景颜色.

相关

GUICtrlCreateListView, GUICtrlSetData, GUICtrlSetState, GUICtrlDelete, GUIGetMsg, GUICtrlRead, GUIDataSeparatorChar (Option)

示例/演示


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

Example()

Func Example()
    Local $listview, $button, $item1, $item2, $item3, $msg

    GUICreate("listview items", 220, 250, 100, 200, -1, $WS_EX_ACCEPTFILES)
    GUISetBkColor(0x00E0FFFF) ; will change background color

    $listview = GUICtrlCreateListView("col1  |col2|col3  ", 10, 10, 200, 150);,$LVS_SORTDESCENDING)
    $button = GUICtrlCreateButton("Value?", 75, 170, 70, 20)
    $item1 = GUICtrlCreateListViewItem("item2|col22|col23", $listview)
    $item2 = GUICtrlCreateListViewItem("............item1|col12|col13", $listview)
    $item3 = GUICtrlCreateListViewItem("item3|col32|col33", $listview)
    GUICtrlCreateInput("", 20, 200, 150)
    GUICtrlSetState(-1, $GUI_DROPACCEPTED) ; to allow drag and dropping
    GUISetState()
    GUICtrlSetData($item2, "|ITEM1")
    GUICtrlSetData($item3, "||COL33")
    GUICtrlDelete($item1)

    Do
        $msg = GUIGetMsg()

        Select
            Case $msg = $button
                MsgBox(0, "listview item", GUICtrlRead(GUICtrlRead($listview)), 2)
            Case $msg = $listview
                MsgBox(0, "listview", "clicked=" & GUICtrlGetState($listview), 2)
        EndSelect
    Until $msg = $GUI_EVENT_CLOSE
EndFunc   ;==>Example