获取选中索引
UI.selectedIndex(layoutName: string, id: string): integer
获取列表框最靠上的选中项索引。 多选时读取选中索引数组第 1 项，也就是最小索引。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 列表框最靠上的选中项索引。
|
界面函数
列表框
设置选中索引
UI.setSelectedIndex(layoutName: string, id: string, index: integer)
设置列表框选中索引。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | index | 整 | 目标项目索引，从 0 开始。 |
返回值无返回值
获取选中索引数组
UI.selectedIndexes(layoutName: string, id: string): string
获取列表框全部选中索引，固定返回升序 JSON 数组。 解析示例： 索引数组 = UI.selectedIndexes(布局名称,控件ID) 数量 = Data.jsonSize(索引数组) 列表索引 = Data.jsonGetInt(索引数组,"["..整转字(position).."]") 循环时 position 从 0 到 数量-1。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 列表框全部选中索引组成的升序 JSON 数组字符。
|
设置选中索引数组
UI.setSelectedIndexes(layoutName: string, id: string, indexes: string)
使用 JSON 数组设置列表框选中索引。 示例：[0,2,4] 传 [] 表示清空。 设置前会校验 JSON 格式和每个索引的范围。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | indexes | 字 | 从 0 开始的索引 JSON 数组。示例：[0,2,4]；填 [] 清空选择。 |
返回值无返回值
获取选中Text
UI.selectedText(layoutName: string, id: string, index: integer): string
按列表索引获取已经选中项目的 Text。 索引填 -1：返回选中索引数组第 1 项的 Text。 索引填 0、1、2……：读取该列表索引的 Text。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | index | 整 | 列表索引从 0 开始；填 -1 读取最靠上的选中项。 |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 指定已选中列表项的 Text 字符。
|
获取选中Value
UI.selectedValue(layoutName: string, id: string, index: integer): string
按列表索引获取已经选中项目的 Value。 索引填 -1：返回选中索引数组第 1 项的 Value。 索引填 0、1、2……：读取该列表索引的 Value。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | index | 整 | 列表索引从 0 开始；填 -1 读取最靠上的选中项。 |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 指定已选中列表项的 Value 字符。
|
获取选择模式
UI.selectMode(layoutName: string, id: string): string
读取列表框当前使用的选择模式。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 列表框当前选择模式的代码。
|
设置选择模式
UI.setSelectMode(layoutName: string, id: string, mode: string)
设置列表框选择模式。 none=只显示，single=单选，multiple=多选，all=全选。 切换到 all 时先选中全部，之后用户仍可取消其中某些项。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | mode | 字 | 列表选择模式：none 只显示，single 单选，multiple 多选，all 全选。 |
返回值无返回值
获取列表项
UI.items(layoutName: string, id: string): string
获取列表框项目 JSON，例如 [{"text":"苹果","value":"apple"}]。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 列表框全部项目组成的 JSON 数组字符。
|
设置列表项
UI.setItems(layoutName: string, id: string, items: string)
批量替换列表框项目；支持逗号/换行文本，也支持 JSON 数组，例如 [{"text":"苹果","value":"apple"},{"text":"香蕉","value":"banana"}]。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | items | 字 | 逗号或换行分隔的文字，或项目 JSON 数组。示例：[{"text":"苹果","value":"apple"}] |
返回值无返回值
插入列表项
UI.insertItem(layoutName: string, id: string, insertPosition: integer, text: string, value: string)
在指定位置插入一项；索引从 0 开始，填 -1 表示添加到末尾，不需要手写 JSON。 示例：UI.insertItem("主页面","id_list",-1,"苹果","apple")。
参数5 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | insertPosition | 整 | 插入索引从 0 开始；填 -1 添加到末尾。 |
| 4 | text | 字 | 项目显示文字。示例：苹果 |
| 5 | value | 字 | 项目内部值。示例：apple |
返回值无返回值
修改列表项
UI.updateItem(layoutName: string, id: string, index: integer, text: string, value: string)
按从 0 开始的索引修改一项的 Text 和 Value，不需要手写 JSON。 示例：UI.updateItem("主页面","id_list",0,"香蕉","banana")。
参数5 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | index | 整 | 目标项目索引，从 0 开始。 |
| 4 | text | 字 | 项目显示文字。示例：苹果 |
| 5 | value | 字 | 项目内部值。示例：apple |
返回值无返回值
删除列表项
UI.deleteItem(layoutName: string, id: string, index: integer)
按从 0 开始的索引删除一项。 示例：UI.deleteItem("主页面","id_list",0)。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | index | 整 | 目标项目索引，从 0 开始。 |
返回值无返回值