描述
多行文本输入框,父对象为ui,无子对象
事件
onTextChange: 文本框文本发生变化时触发。
onEditFinish:当按下输入键盘OK按钮时触发。
onEditCancel:当按下输入键盘Cancel按钮时触发。
onFocusIn:当文本框获得输入焦点时触发。
onUserEvent: 接收自定义事件,当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发。
属性
名称 | 功能说明 | 脚本例子 |
x | x坐标 (只读属性) | var x = ui.form-name.multilineinput-name.x; 获取对象的x坐标 |
y | y坐标 (只读属性) | var y = ui.form-name.multilineinput-name.x; 获取对象的y坐标 |
width | 宽 (只读属性) | var width = ui.form-name.multilineinput-name.width; 获取对象的宽 |
height | 高 (只读属性) | var height = ui.form-name.multilineinput-name.width; 获取对象的高 |
enabled | 使能:如果选中,对象处于激活状态,否则处于“禁止”状态,对所有触摸操作无反应。 | ui.form-name.multilineinput-name.enabled=0 禁止对象 |
visible | 可见:如果选中,对象可见,否则隐藏 | ui.form-name.multilineinput-name.visible=0 隐藏对象 |
text | 文本内容 | ui.form-name.multilineinput-name.text='test' 设置对象当前语言环境下的文本内容为test |
autoScroll | 如果输入文本超出输入框大小自动增加滑动条 | ui.form-name.multilineinput-name.autoScroll=1 设置对象自动增加滑动条 |
readOnly | 只读,如果为true,对象只能显示文本,无法输入 | ui.form-name.multilineinput-name.readOnly=1 设置对象为只读 |
verbose | 事件通知:当触发条件满足时,ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。 | ui.form-name.multilineinput-name.verbose=1 设置对象触发的事件有效时向串口发送事件消息 |
textColor | 文字颜色, 颜色定义参看 控件对象 | ui.form-name.multilineinput-name.textColor='#ff0000' 设置文字颜色为红色 |
borderColor | 边框颜色,颜色定义参看 控件对象 | ui.form-name.multilineinput-name.borderColor='#00ff00' 设置边框为绿色 |
borderWidth | 边框宽度,单位:像素 | ui.form-name.multilineinput-name.borderWidth=5 设置对象边框宽为5个像素 |
borderRadius | 边框拐角弧度半径,单位:像素 | ui.form-name.multilineinput-name.borderRadius=8 设置对象边框拐角半径为8个像素 |
borderType | 边框类型。支持0-Inset,1-Outset,2-Dotted,3-Solid,4-No_Border。 | ui.form-name.multilineinput-name.borderType=4 设置对象无边框 |
backgroundColor | 背景色,颜色定义参看 控件对象 | ui.form-name.multilineinput.backgroundColor='#ff0000' 设置背景为红色 |
backgroundColorType | 背景色类型:linear-1,linear-2,radial-1,radial-2, circle,pure, none可选 | ui.form-name.multilineinput-name.backgroundColorType='circle' 设置对象背景颜色类型为circle |
readOnlyBackgroundColor | 只读时背景色,颜色定义参看 控件对象 | ui.form-name.multlineinput-name.readOnlyBackgroundColor='#ff0000' 设置输入框只读时背景色为红色 |
editingBackgroundColor | 编辑时背景色,颜色定义参看 控件对象 | ui.form-name.multilineinput-name.editingBackgroundColor='#00ff00' 设置输入框编辑时背景色为绿色 |
scrollBarColor | 滑动条颜色,颜色定义参看 控件对象 | ui.form-name.multilineinput-name.scrollBarColor='#ff0000' 设置滚动条颜色为红色 |
scrollBarBackgroundColor | 滑动条背景颜色,颜色定义参看 控件对象 | ui.form-name.multilineinput-name.scrollBarBackgroundColor='#ff0000' 设置滚动条背景为红色 |
scrollBarBackgroundColorType | 滑动条背景颜色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 | ui.form-name.multilineinput-name.scrollBarbackgroundColorType=4 设置对象滑动条背景颜色类型为Circle |
scrollBarWidth | 滑动条宽度,单位:像素 | ui.form-name.multilineinput-name.scrollBarWidth=20 设置对象滑动条宽度为20个像素 |
defaultInputMethod | 默认输入法, 0-Letter,1-Number,2-None (隐藏软键盘) | ui.form-name.multilineinput-name.defaultInputMethod=1 设置默认输入法为数字键盘 |
方法
名称 | 功能说明 | 脚本例子 |
setText(string, index) | 设置语言环境为index时的文字标识:string为文字字符串,index为语言环境索引值。当通过service.setLanguage(index)设置对应的语言环境时,该文字字符串自动显示。 | ui.form-name.multilineinput-name.setText('测试', 1) 设置语言环境1下的文字标识为'测试',当切换到语言环境1时,该标识自动显示替代之前的语言环境字符串 |
setFontSize(size) | 设置字体大小 | ui.form-name.multilineinput-name.setFontSize(12) 设置字体为12号 |
backspace() | 回退操作,删除最后一个字符 | ui.form-name.multilineinput-name.backspace() 删除最后一个字符 |
append(text) | 追加字符串,参数text为字符串 | ui.form-name.multilineinput-name.append('A') 在最后面追加一个字符'A' |
setFocus() | 设置获取输入焦点(但不弹出软键盘) | ui.form-name.multilineinput-name.setFocus() 设置获取输入焦点 |
move(x,y) | 移动对象:将对象移动到(x,y)坐标位置,坐标系的原点在屏幕的左上角。 | ui.form-name.multilineinput-name.move(10,10) 移动对象到坐标(10,10) |
resize(width, height) | 设置对象宽和高 | ui.form-name.multilineinput-name.resize(30,20) 设置对象宽30像素,高20像素 |