Lua接口/客户端/CtrlList/AddNewItem

来自天龙知识库
Waylee留言 | 贡献2026年9月19日 (六) 17:06的版本 (新建客户端 Lua 接口页:全局函数、对象方法、窗口操作与客户端事件)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航跳到搜索

首页 · 客户端接口 · 窗口操作

CtrlList:AddNewItem
读取客户端本地数据 · 实现于 CEGUISystem/UILuaControl.cpp

调用方式

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)

关联

  • 读取或修改客户端本地数据