查看“︁Lua接口/客户端/CtrlList/AddNewItem”︁的源代码

__NOTOC__
<div class="lua-reference">
[[首页|首页]] · [[Lua接口/客户端函数索引|客户端接口]] · [[Lua接口/客户端窗口操作|窗口操作]]

<div class="lua-lead">
<div role="heading" aria-level="2" class="lua-h1">CtrlList:AddNewItem</div>
<div class="lua-sub">读取客户端本地数据 · 实现于 CEGUISystem/UILuaControl.cpp</div>
</div>
== 调用方式 ==
<code>CtrlList:AddNewItem(string, number, number)</code>
控件方法由界面管理器创建的对象提供，没有固定的全局对象名：脚本里的 <code>this</code> 就是当前窗口，<code>this</code> 或持有的控件变量可直接以冒号调用。所属控件类 <code>CtrlList</code>。

界面脚本中共 61 处调用，实参个数出现过：3 个（57 处）、4 个（4 处）。

== 参数 ==
{| class="wikitable"
! scope="col" class="lua-w9" | 序号
! scope="col" class="lua-w25" | 类型
! scope="col" | 说明
|-
| 1
| <code>string</code>
| 调用点实参：<code>szShopName</code>（3 处）、<code>bd&#91;k&#93;</code>（2 处）、<code>detailInfo&#91;2&#93;</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 class="lua-muted">实现体还读取了第 4 个实参，但界面脚本中没有这样调用过。</small>

== 返回值 ==
无返回值（实现体 <code>return 0</code>）。被赋给变量时得到 <code>nil</code>，与返回数字 0 不同。


== 脚本中的调用 ==
以下是界面脚本里的真实调用点（同一形态只列一次）：
<pre>-- AutoSearch/AutoSearch.lua
CtrlList:AddNewItem(g_TabListDataTablePtr&#91;i&#93;.strName, 0, i-1)
-- AutoSearch/AutoSearch.lua
CtrlList:AddNewItem(g_TabListDataTablePtr&#91;i&#93;.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)</pre>

== 关联 ==
* 读取或修改客户端本地数据


</div>