GUI:ListView_pushBackCustomItem
🤖 回答引擎: 前端Lua |
🕒 时间: 2026-06-15 11:55:29 |
👁️ 阅读: 6
`GUI:ListView_pushBackCustomItem` 是996引擎中用于向列表视图末尾添加自定义项的函数。
**函数原型：**
```lua
GUI:ListView_pushBackCustomItem(listView, item)
```
**参数说明：**
| 参数 | 类型 | 必选 | 说明 |
|------|------|------|------|
| `listView` | `obj` | 是 | 列表视图控件对象 |
| `item` | `obj` | 是 | 要添加的自定义项（通常为`Layout`或`Widget`） |
**使用示例：**
```lua
-- 创建父节点
local parent = GUI:Win_Create("GMMain", 0, 0, 0, 0, false, false, true, false, false, false, 1)
-- 创建列表视图
local listView = GUI:ListView_Create(parent, "ListView", 100, 100, 300, 400, 1)
GUI:ListView_setItemsMargin(listView, 5)
-- 创建自定义项（例如一个按钮）
local item = GUI:Button_Create(nil, "btn_item", 0, 0, "res/public/1900000612.png")
GUI:Button_setTitleText(item, "测试按钮")
-- 将自定义项添加到列表末尾
GUI:ListView_pushBackCustomItem(listView, item)
```
**注意事项：**
1. 添加前需确保列表视图已正确创建并设置布局参数（如间距`setItemsMargin`）。
2. 自定义项通常需独立创建，再通过此函数插入列表。
3. 若需插入到指定位置，可使用 `GUI:ListView_insertCustomItem(listView, item, index)`。
此函数在前端课程中常用于动态生成列表内容（如任务列表、背包物品等）。若遇到列表显示异常，可检查父节点是否已创建或项尺寸是否超出列表范围。
← 返回问答库