函数: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。

Copyright 北京帮你玩科技有限公司 2023 all right reserved,powered by Gitbook该文章修订时间: 2024-03-06 17:50:18

results matching ""

    No results matching ""