函数:UITextArea 多行文本框
函数名称:多行文本框
TSLib 版本:仅支持函数库 v1.2.4 及其以上版本
函数功能:一般来用显示多行说明文字或者标题
函数方法
UITextArea(num,id,prompt,text,size,align,color,kbtype,width,nowrap,height)
参数 | 类型 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
num | number | 否 | 控件所在页面页数,不能超过 UINew 的 pagination 参数 | 1 |
id | string | 是 | 控件 ID,用于接收该控件的返回值 | - |
prompt | string | 是 | 提示文字(仅支持 Android) | - |
text | string | 是 | 默认文字,编辑框默认内容 | - |
size | number | 否 | 字号,字体大小 | 15 |
align | string | 否 | 对齐方式,左对齐 - left,右对齐 - right,居中 - center | "left" |
color | string | 否 | 文字颜色,使用 RGB 十进制数值,以英文半角逗号分割 | "0,0,255" |
kbtype | string | 否 | 键盘类型,类型有 number ascii default 三种 |
"default" |
width | number | 否 | 控件宽度,默认 -1 为一行, 自定义宽度可写其他数值, Android 设备仅支持整数否则会提示 UI 格式错误 |
-1 |
nowrap | number | 否 | 指定下一个控件是否换行,当此属性为 1 时, 将指定下一个控件不换行 |
0 |
height | number | 否 | 控件高度,支持 iOS v2.4.5-3、 Android v2.3.3.2 及其以上版本, Android 为默认高度,此参数 Android 写入数值不生效 |
- |
返回值 | 类型 | 说明 |
---|---|---|
id | 字符串 | 根据控件 ID 返回文本框的内容 |
函数用例
--控件在一行
require "TSLib"--使用本函数库必须在脚本开头引用
UINew()
--可选参数如果写部分的话,该参数前的所有参数都必须需要填写,否则会报错
--返回值为字符串,若文本框内容未改变,则返回 text1 == 测试1",text2 == "测试2"
UITextArea("text1","文本框1","测试1",30,"center","0,0,255","",200,1)
UITextArea("text2","文本框2","测试2",15,"left","0,0,255","",200,1)
UIShow()
dialog(text1.."\r\n"..text2)
注意事项
可选参数如果写部分的话,该参数前的所有参数都必须需要填写,否则会报错。
iOS 设备 width 参数不能写的过小,否则可能出现无法选择参数的问题,出现此问题请调整 width 参数。
想要多个控件显示在一行,需要使用 width 及 nowrap 参数, width 不能为 -1 需要根据屏幕宽度进行调整,nowrap 需要为 1。