ReadUIConfig是按键精灵静态 UI 设计的核心函数,无需复杂逻辑,就能快速读取你在「UI 编辑器」中创建的控件配置:
- 按钮的显示文本、位置坐标、是否可用;
- 输入框的默认内容、最大输入长度;
- 复选框的勾选状态、下拉框的选中选项;
- 所有控件的显示 / 隐藏状态、宽高尺寸……
函数功能
读取静态UI指定控件的配置
函数语法
result = ReadUIConfig(name[,defaultValue] [,reload])
函数参数
| 参数名 | 参数类型 | 是否必选 | 参数说明 |
|---|---|---|---|
| name | string | 是 | 需读取配置的静态UI控件名称,区分大小写 |
| defaultValue | string | 否 | 未读取到配置时的默认值 |
| reload | bool | 否 | 是否重新从本地uiConfig文件中读取配置 true:从本地uiConfig文件中重新读取配置,并刷新缓存 false:使用缓存中的配置,该缓存在启动引擎后执行脚本代码前会自动生成一次 默认:false 备注:该参数在助手v4.3.0、安卓v4.0.0、iOS新版引擎v2.5.0及以上版本生效 |
函数返回
| 返回名 | 返回类型 | 返回说明 |
|---|---|---|
| result | 输入框:string 多选框:bool 下拉框:int | 读取到的指定控件的配置,未读取到则返回默认值 输入框返回值类型为字符串,如需用做数值逻辑,请注意类型转换 下拉框返回的索引值从0开始 |
代码范例
import "shanhai.lua"
dim ret,eleList={"输入框1","下拉框1","多选框1"}
Do
For i = 1 To Len(eleList)
//从本地uiConfig文件中重新读取配置,并刷新缓存
ret = ReadUIConfig(eleList[i], "defaultValue", true)
TracePrint ret,shanhai.type(ret)
Delay 500
//使用缓存中的配置
ret = ReadUIConfig(eleList[i], "defaultValue", false)
TracePrint ret,shanhai.type(ret)
Delay 500
//使用缓存中的配置
ret = ReadUIConfig(eleList[i], "defaultValue")
TracePrint ret,shanhai.type(ret)
Delay 500
Next
Loop
功能通用灵活,覆盖全场景自动化需求
无论是:
- 办公场景:批量填写表单时,读取输入框默认模板、按钮触发位置;
- 游戏场景:适配不同分辨率的游戏 UI,读取技能按钮坐标、复选框勾选状态;
- 批量操作:读取下拉框选项总数、标签提示文本,实现多场景复用脚本;
ReadUIConfig 都能精准匹配需求,让自动化脚本更 “聪明”、更通用!

被折叠的 条评论
为什么被折叠?



