Lua接口/客户端/CtrlList/AddNewItem
来自天龙知识库
CtrlList:AddNewItem
读取客户端本地数据 · 实现于 CEGUISystem/UILuaControl.cpp
本页信息由客户端 C++ 绑定源码与 230 个界面脚本自动整理：参数取实现体的
args[n] 取值点（对象方法已扣除 self 占用的栈位），调用示例取脚本中的真实调用，未经运行验证；用途摘要按实现体归纳，仅供参考。调用方式
CtrlList:AddNewItem(string, number, number)
控件方法由界面管理器创建的对象提供，没有固定的全局对象名：脚本里的 this 就是当前窗口，this 或持有的控件变量可直接以冒号调用。所属控件类 CtrlList。
界面脚本中共 61 处调用，实参个数出现过：3 个（57 处）、4 个（4 处）。
参数
| 序号 | 类型 | 说明 |
|---|---|---|
| 1 | string
|
调用点实参：szShopName（3 处）、bd[k]（2 处）、detailInfo[2]（2 处）
|
| 2 | number
|
调用点实参：1（20 处）、0（18 处）、2（13 处）
|
| 3 | number
|
调用点实参：i（45 处）、i-1（8 处）、i-startIndex（4 处）
|
实现体还读取了第 4 个实参，但界面脚本中没有这样调用过。
返回值
无返回值（实现体 return 0）。被赋给变量时得到 nil，与返回数字 0 不同。
脚本中的调用
以下是界面脚本里的真实调用点（同一形态只列一次）：
-- AutoSearch/AutoSearch.lua CtrlList:AddNewItem(g_TabListDataTablePtr[i].strName, 0, i-1) -- AutoSearch/AutoSearch.lua CtrlList:AddNewItem(g_TabListDataTablePtr[i].strInfo, 1, i-1) -- ConfraternityList/ConfraternityList.lua CtrlList:AddNewItem(tostring(guildId), 0, i) -- ConfraternityList/ConfraternityList.lua CtrlList:AddNewItem(szHasCity..szNewGuild..guildName, 1, i) -- ConfraternityList/ConfraternityList.lua CtrlList:AddNewItem(GetColorBoomValueStr(boomValue), 2, i) -- ConfraternityList/ConfraternityList.lua CtrlList:AddNewItem(guildLevel, 3, i) -- ConfraternityList/ConfraternityList.lua CtrlList:AddNewItem(tostring(weekScore), 4, i)
关联
- 读取或修改客户端本地数据
参数与返回值由实现体的取值点推断（对象方法已扣除
self 占用的栈位），调用示例取自 230 个界面脚本；均为静态整理，未在游戏内执行验证。