获取选中索引
UI.selectedIndex(layoutName: string, id: string): integer
读取下拉列表当前选中项的位置。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 下拉列表当前选中项的 0 基索引。
|
界面函数
下拉列表
设置选中索引
UI.setSelectedIndex(layoutName: string, id: string, index: integer)
设置下拉列表当前选中索引。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | index | 整 | 目标项目索引，从 0 开始。 |
返回值无返回值
获取选中Text
UI.selectedText(layoutName: string, id: string): string
读取下拉列表当前选中项的 Text。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 下拉列表当前选中项的 Text 字符。
|
获取选中Value
UI.selectedValue(layoutName: string, id: string): string
读取下拉列表当前选中项的 Value。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 字 | 下拉列表当前选中项的 Value 字符。
|
获取选项列表
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, options: string)
批量替换下拉列表选项；支持逗号/换行文本，也支持 JSON 数组，例如 [{"text":"苹果","value":"apple"},{"text":"香蕉","value":"banana"}]。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | options | 字 | 逗号或换行分隔的文字，或项目 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 开始。 |
返回值无返回值