Lua接口/客户端/CtrlList/AddNewItem：修订间差异
来自天龙知识库
跳到导航跳到搜索
新建客户端 Lua 接口页：全局函数、对象方法、窗口操作与客户端事件 |
新建客户端 Lua 接口页：全局函数、对象方法、窗口操作与客户端事件 |
||
| 第1行： | 第1行： | ||
__NOTOC__ | __NOTOC__ | ||
<div class="lua-reference | <div class="lua-reference"> | ||
[[首页|首页]] · [[Lua接口/客户端函数索引|客户端接口]] · [[Lua接口/客户端窗口操作|窗口操作]] | [[首页|首页]] · [[Lua接口/客户端函数索引|客户端接口]] · [[Lua接口/客户端窗口操作|窗口操作]] | ||
<div | <div class="lua-lead"> | ||
<div role="heading" aria-level="2" | <div role="heading" aria-level="2" class="lua-h1">CtrlList:AddNewItem</div> | ||
<div | <div class="lua-sub">读取客户端本地数据 · 实现于 CEGUISystem/UILuaControl.cpp</div> | ||
</div> | </div> | ||
== 调用方式 == | == 调用方式 == | ||
<code | <code>CtrlList:AddNewItem(string, number, number)</code> | ||
控件方法由界面管理器创建的对象提供，没有固定的全局对象名：脚本里的 <code | 控件方法由界面管理器创建的对象提供，没有固定的全局对象名：脚本里的 <code>this</code> 就是当前窗口，<code>this</code> 或持有的控件变量可直接以冒号调用。所属控件类 <code>CtrlList</code>。 | ||
界面脚本中共 61 处调用，实参个数出现过：3 个（57 处）、4 个（4 处）。 | 界面脚本中共 61 处调用，实参个数出现过：3 个（57 处）、4 个（4 处）。 | ||
== 参数 == | == 参数 == | ||
{| class="wikitable | {| class="wikitable" | ||
! scope="col" | ! scope="col" class="lua-w9" | 序号 | ||
! scope="col" | ! scope="col" class="lua-w25" | 类型 | ||
! scope="col | ! scope="col" | 说明 | ||
|- | |- | ||
| 1 | |||
| <code>string</code> | |||
| 调用点实参：<code>szShopName</code>（3 处）、<code>bd[k]</code>（2 处）、<code>detailInfo[2]</code>（2 处） | |||
|- | |- | ||
| 2 | |||
| <code>number</code> | |||
| 调用点实参：<code>1</code>（20 处）、<code>0</code>（18 处）、<code>2</code>（13 处） | |||
|- | |- | ||
| 3 | |||
| <code>number</code> | |||
| 调用点实参：<code>i</code>（45 处）、<code>i-1</code>（8 处）、<code>i-startIndex</code>（4 处） | |||
|} | |} | ||
<small | <small class="lua-muted">实现体还读取了第 4 个实参，但界面脚本中没有这样调用过。</small> | ||
== 返回值 == | == 返回值 == | ||
无返回值（实现体 <code | 无返回值（实现体 <code>return 0</code>）。被赋给变量时得到 <code>nil</code>，与返回数字 0 不同。 | ||
== 脚本中的调用 == | == 脚本中的调用 == | ||
以下是界面脚本里的真实调用点（同一形态只列一次）： | 以下是界面脚本里的真实调用点（同一形态只列一次）： | ||
<pre | <pre>-- AutoSearch/AutoSearch.lua | ||
CtrlList:AddNewItem(g_TabListDataTablePtr[i].strName, 0, i-1) | CtrlList:AddNewItem(g_TabListDataTablePtr[i].strName, 0, i-1) | ||
-- AutoSearch/AutoSearch.lua | -- AutoSearch/AutoSearch.lua | ||
2026年9月19日 (六) 17:06的最新版本
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)
关联
- 读取或修改客户端本地数据
