ListView_insertCustomItem
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-07-18 15:42:18 |
👁️ 阅读: 15
`GUI:ListView_insertCustomItem(listView, widget, index)` 是向 ListView 指定位置插入自定义项的函数。
**参数说明:**
- `listView` (obj, 必选): ListView 控件对象
- `widget` (obj, 必选): 要插入的控件对象
- `index` (int, 必选): 插入位置的索引(从 1 开始)
**使用示例:**
```lua
-- 创建父节点
local parent = GUI:Win_Create("GMMain", 0, 0, 0, 0, false, false, true, false, false, false, 1)
-- 创建 ListView
local listView = GUI:ListView_Create(parent, "ListView_1", 100, 100, 200, 300, 1)
-- 创建要插入的控件项
local item = GUI:Layout_Create(listView, "item_1", 0, 0, 200, 50, false)
-- 在索引 1 的位置插入项
GUI:ListView_insertCustomItem(listView, item, 1)
-- 也可以在末尾添加(替代方法)
GUI:ListView_pushBackCustomItem(listView, item)
```
**相关函数:**
- `GUI:ListView_pushBackCustomItem(listView, widget)` - 添加到末尾
- `GUI:ListView_getItemIndex(listView, widget)` - 获取项的索引
- `GUI:ListView_getItems(listView)` - 获取所有项
- `GUI:ListView_removeAllItems(listView)` - 清空所有项
**注意事项:**
1. 插入前需要先创建控件项
2. 索引从 1 开始,不是 0
3. 插入后可能需要调用 `GUI:ListView_doLayout(listView)` 刷新布局
4. 使用前确保 ListView 已正确创建
这个函数在动态创建列表项时非常有用,可以根据需要将控件插入到特定位置。
← 返回问答库