获取控件X坐标
UI.x(layoutName: string, id: string): integer
获取运行态控件的逻辑 X 坐标。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数；控件不存在或读取失败返回 0。 |
界面函数
通用属性
设置控件X坐标
UI.setX(layoutName: string, id: string, x: integer)
设置运行态控件的逻辑 X 坐标。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | x | 整 | 控件左上角的逻辑 X 坐标。 |
返回值无返回值
获取控件Y坐标
UI.y(layoutName: string, id: string): integer
获取运行态控件的逻辑 Y 坐标。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数；控件不存在或读取失败返回 0。 |
设置控件Y坐标
UI.setY(layoutName: string, id: string, y: integer)
设置运行态控件的逻辑 Y 坐标。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | y | 整 | 控件左上角的逻辑 Y 坐标。 |
返回值无返回值
获取控件宽度
UI.w(layoutName: string, id: string): integer
获取运行态控件的逻辑宽度。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数；控件不存在或读取失败返回 0。 |
设置控件宽度
UI.setW(layoutName: string, id: string, width: integer)
设置运行态控件的逻辑宽度。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | width | 整 | 控件的逻辑宽度，不能小于 0。 |
返回值无返回值
获取控件高度
UI.h(layoutName: string, id: string): integer
获取运行态控件的逻辑高度。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数；控件不存在或读取失败返回 0。 |
设置控件高度
UI.setH(layoutName: string, id: string, height: integer)
设置运行态控件的逻辑高度。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | height | 整 | 控件的逻辑高度，不能小于 0。 |
返回值无返回值
获取控件层级
UI.z(layoutName: string, id: string): integer
获取运行态控件的层级 z。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数；控件不存在或读取失败返回 0。 |
设置控件层级
UI.setZ(layoutName: string, id: string, zIndex: integer)
设置运行态控件的层级 z。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | zIndex | 整 | 控件层级；数值越大越靠上显示。 |
返回值无返回值
获取可见状态
UI.visible(layoutName: string, id: string): integer
获取控件是否可见，返回 1 或 0。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数，1 表示可见，0 表示隐藏或控件不存在。 |
设置可见状态
UI.setVisible(layoutName: string, id: string, visible: integer)
设置控件是否可见，1 为可见，0 为隐藏。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | visible | 整 | 1 显示控件，0 隐藏控件。 |
返回值无返回值
获取可用状态
UI.enabled(layoutName: string, id: string): integer
获取控件是否可用，返回 1 或 0。
参数2 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
返回值至少接收一个返回值
| 序号 | 名称 | 类型 | 返回说明 |
|---|---|---|---|
| 1 | result | 整 | 返回整数，1 表示可用，0 表示禁用或控件不存在。 |
设置可用状态
UI.setEnabled(layoutName: string, id: string, enabled: integer)
设置控件是否可用，1 为可用，0 为禁用。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | enabled | 整 | 1 允许操作控件，0 禁用控件。 |
返回值无返回值
设置控件背景色
UI.setBackgroundColor(layoutName: string, id: string, color: string)
设置控件背景颜色，例如 #FF3A6EFF；参数行可点击“选择颜色”。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | color | 字 | 背景颜色，格式 #AARRGGBB。示例：#FF3A6EFF |
返回值无返回值
设置控件背景图片
UI.setBackgroundImage(layoutName: string, id: string, imagePath: string)
设置设备绝对路径中的背景图片；传空字符可清除。
参数3 项
| 序号 | 名称 | 类型 | 参数说明 |
|---|---|---|---|
| 1 | layoutName | 字 | 目标布局名称。示例：主页面 |
| 2 | id | 字 | 目标控件 ID。示例：id_start |
| 3 | imagePath | 字 | 图片绝对路径。示例：/sdcard/背景.png；传空字符可清除 |
返回值无返回值