函数:UINew 创建 UI
函数名称:创建 UI
函数功能:UI 创建初始化
函数方法
UINew(pagination,titles,okname,cancelname,config,orient,timer,width,height,bgcolor,btnbkcolor,bg,pagenumtype,selpage,titlesize, titlealign)
返回值:无
| 参数 | 属性名 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|---|
| pagination | UI 显示页数 | number | 否 | 显示的脚本配置页数 | 1 |
| titles | 标题 | string | 否 | 多页标题,用于指定 UI 顶部标题栏文字, pagenumtype 为 tab 时为多页模式 可以设置多个标题对应多个页面(多页二级标题), 以逗号分隔 |
"脚本配置" |
| okname | 确定按钮文字 | string | 否 | UI 底部右侧文字 | "开始" |
| cancelname | 取消按钮文字 | string | 否 | UI 底部左侧文字 | "取消" |
| config | 配置文件 | string | 否 | 配置文件,保存配置到该文件 | "uiconfig.dat" |
| orient | iOS UI 方向 | number | 否 | UI 方向,仅支持 iOS, 0 - 向下;1 - 向右;2 - 向左 |
0 |
| timer | 倒计时秒数 | number | 否 | 倒计时时间,单位:秒。倒计时完成自动开始 | 120 |
| width | UI 宽度 | number | 否 | 脚本配置显示宽度, Android 设备仅支持整数否则会提示 UI 格式错误 |
屏幕宽度 |
| height | UI 高度 | number | 否 | 脚本配置显示高度, Android 设备仅支持整数否则会提示 UI 格式错误 |
屏幕高度 |
| bgcolor | 背景颜色 | string | 否 | 使用 RGB 十进制数值 以英文半角逗号分割 |
"248,248,248" |
| btnbkcolor | 按钮背景色 | string | 否 | 使用 RGB 十进制数值 以英文半角逗号分割 |
"248,248,248" |
| bg | 背景图片 | string | 否 | 相对路径为 res 目录 可填写绝对路径 |
- |
| pagenumtype | 分页指示样式 | string | 否 | dot - 小圆点 number - 数字;default - 不显示; tab - 底部不显示页码样式, 在顶部将分页标题显示为二级标签, 仅支持 Androidv3.2.0、iOSv3.1.5 及其以上版本 |
"default" |
| selpage | 默认停留页面 | number | 否 | 默认停留页面 | 1 |
| titlesize | 标题字号 | number | 否 | titles 字体大小, 仅支持 Androidv3.2.1、iOSv3.1.6 及其以上版本, 仅支持 v1.3.4 及其以上版本 TSLib |
15 |
| titlealign | 标题对齐 | string | 否 | titles 对齐方式,默认左对齐。 可取值为:左对齐 left, 右对齐 right,居中 center, 仅支持 Androidv3.2.1、iOSv3.1.6 及其以上版本, 仅支持 v1.3.4 及其以上版本 TSLib |
“left” |
| 函数用例 |
require "TSLib"--此函数库已内置,无需单独下载及打包
w,h = getScreenSize()
UINew("我的脚本","运行脚本","退出脚本","uiconfig.dat",0,120,w*0.9,h*0.9,"255,231,186","255,231,186") --方式一,宽高为屏幕的 90%
UIShow()
--titlealign、titlesize 仅支持 Androidv3.2.1、iOSv3.1.6 及其以上版本,仅支持 v1.3.4 及其以上版本 TSLib
--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
require "TSLib"
w,h = getScreenSize()
UINew("我的脚本1,我的脚本2","运行脚本","退出脚本","uiconfig.dat",0,120,w*0.9,h*0.9,"255,231,186","255,231,186","","tab",1,15,"right") --方式一,宽高为屏幕的 90%
UIShow()
require "TSLib"--此函数库已内置,无需单独下载及打包
w,h = getScreenSize()
UINew({titles="我的脚本",okname="运行脚本",cancelname="退出脚本"}) --方式二
UIShow()
注意事项
默认配置文件路径:
触动精灵 iOS 配置文件目录:/var/mobile/Media/TouchSprite/config/
触动精灵安卓配置文件目录:/mnt/sdcard/TouchSprite/config/
iOS 小精灵配置文件目录:/var/mobile/Media/小精灵包名/config/
安卓小精灵配置文件目录:/mnt/sdcard/
个人版 iOS 配置文件目录:/var/mobile/Media/TouchSpritePe/config/
可选参数如果写部分的话,该参数前的所有参数都必须需要填写,否则会报错。其他控件也一样
标题 titles,如果每页标题显示不一样该项请用逗号隔开,如:"标题1,标题2,标题3"
函数有两种传入方式,普通和 table 方式,table 方式可选择性写入,在 table 方式下可以使用 title 来修改顶部标题栏名称。
函数方法内没有的参数,可以用 table 方式实现
使用 pagenumtype 参数中的 tab 会在顶部将 titles 内容显示为二级分页标签,非 tab 会将 titles 内容显示为顶部分页标题。