函数：UICheck 多选组合
函数名称：多选组合
函数功能：多项选择返回
函数方法
UICheck(num,id,list,sel,width,nowrap,images,scale,countperline)
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
| num | number | 否 | 控件所在页面页数，不能超过 UINew 的 pagination 参数 | 1 |
| id | string | 是 | 控件 ID，用于接收该控件的返回值，多个可选项目之间用英文半角逗号分割 | - |
| list | string | 是 | 文字选项，需要与 id 中项目数量相同，多个选项之间用英文逗号分割 | - |
| sel | string | 否 | 默认选项编号，需填写选项编号，第一个选项编号为 0， 第二个选项编号为 1，依次类推；填写多个时以 @ 分割； 默认不选填空字符串 "" |
"0" |
| width | number | 否 | 控件宽度，默认 -1 为一行， 自定义宽度可写其他数值， Android 设备仅支持整数否则会提示 UI 格式错误 |
-1 |
| nowrap | number | 否 | 指定下一个控件是否换行， 当此属性为 1 时将指定下一个控件不换行 |
0 |
| images | string | 否 | 图片选项，可以和 list 属性同时使用， 多个图片资源用英文半角逗号分割 |
"" |
| scale | number | 否 | 图片缩放范围 0 - 1 | 1 |
| countperline | number | 否 | 单行控件显示数量，Android 默认 1 行显示 1 个， iOS 控件总宽度超过屏幕宽度则堆积在一起， 引擎版本支持 iOS v3.00-157 及 Android v2.3.6 及其以上版本， 仅支持 TSLib 函数库 v1.2.4 及其以上版本 |
- |
| 返回值 | 类型 | 说明 |
|---|---|---|
| id | 字符串 | 根据控件 ID 返回选择选项的内容，未选择返回 nil |
函数用例
require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UICheck("check1,check2,check3","选项1,选项2,选项3","0@1",-1,0,"",1,1)-- 0@1 代表默认选项：选项1 和选项2
UIShow()
--返回值为字符串，选中第一个和第二个选项的话，则 check1 == "选项1",check2 == "选项2"，以此类推
if check1 == "选项1" then
dialog("您选择了选项1",3)
end
if check2 == "选项2" then
dialog("您选择了选项2",3)
end
if check3 == "选项3" then
dialog("您选择了选项3",3)
end
--控件在一行
require "TSLib"--使用本函数库必须在脚本开头引用并将文件放到设备 lua 目录下
UINew()
UICheck("check1,check2,check3","选项1,选项2,选项3","0@1",200,1)--默认选项：选项1 和选项2
UICheck("check4,check5,check6","选项4,选项5,选项6","0@1",200,1)--默认选项：选项4 和选项5
UIShow()
注意事项
可选参数如果写部分的话，该参数前的所有参数都必须需要填写，否则会报错。
有多少个文字选项需要创建多少个变量来赋值。
由于多选组合为允许并存的选择，判断返回值需要用到多个 if...then..end 判断语句。
iOS 设备 width 参数不能写的过小，否则可能出现无法选择参数的问题，出现此问题请调整 width 参数。
想要多个控件显示在一行，需要使用 width 及 nowrap 参数， width 不能为 -1 需要根据屏幕宽度进行调整，nowrap 需要为 1。