单行输入框-singlelineinput
描述
单行文本输入框，父对象为ui，无子对象
事件
textchange： 文本框文本发生变化时触发。事件函数定义: onTextChange(text)，参数text为新的文本值
editfinish：当按下输入键盘OK按钮时触发。事件函数定义: onEditFinish()
editcancel：当按下输入键盘Cancel按钮时触发。事件函数定义: onEditCancel()
focusin：当文本框获得输入焦点时触发。事件函数定义: onFocusIn()
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
geometryLocked |
区域锁定，锁定后控件的位置及大小不能修改 |
无 |
x |
x坐标 （只读属性） |
var x = ui.form-name.singlelineinput-name.x; 获取对象的x坐标 |
y |
y坐标 （只读属性） |
var y = ui.form-name.singlelineinput-name.y; 获取对象的y坐标 |
width |
宽 （只读属性） |
var width = ui.form-name.singlelineinput-name.width; 获取对象的宽 |
height |
高 （只读属性） |
var height = ui.form-name.singlelineinput-name.width; 获取对象的高 |
marginRight |
右外边距 （只读属性） |
无 |
marginBottom |
底外边距 （只读属性） |
无 |
enabled |
使能：如果选中，对象处于激活状态，否则处于’禁止”状态，对所有触摸操作无反应。 |
ui.form-name.singlelineinput-name.enabled=0 禁止对象 |
visible |
可见：如果选中，对象可见，否则隐藏 |
ui.form-name.singlelineinput-name.visible=0 隐藏对象 |
verbose |
事件通知：当触发条件满足时，ExpOS主动向device.io.com0发送事件消息。仅当选择串口通讯协议为script mode时适用。 |
ui.form-name.singlelineinput-name.verbose=1 设置对象触发的事件有效时向串口发送事件消息 |
text |
文本内容 |
ui.form-name.singlelineinput-name.text=’test” 设置对象的当前语言环境下的文本内容为’test’ |
maxLength |
文字最大输入长度（默认32767） |
ui.form-name.maxLength=5 设置最大输入长度为5 |
echoMode |
回显模式， 值为0-Normal， 1-NoEcho，2-Password，3-PasswordEchoOnEdit |
ui.form-name.singlelineinput-name.echoMode=2 设置对象回显模式为密码（星号*代替实际的字符） |
cursorPosition |
输入光标位置 |
ui.form-name.singlelineinput-name.cursorPosition=6 设置输入光标在第6个字符位置 |
readOnly |
只读，如果为true，对象只能显示文本，无法输入 |
ui.form-name.singlelineinput-name.readOnly=1 设置对象为只读 |
numberOnly |
只能输入数字，获取焦点后软键盘自动切换到数字模式 |
ui.form-name.singleinput-name.numberOnly=1 设置只能输入数字 |
decimalPlaces |
小数位 |
ui.form-name.singleinput-name.decimalPlaces=3 设置允许输入小数点后3位 |
validator |
验证器，值为正则表达式字符串 |
ui.form-name.singleinput-name.validator=’[0-9]+$’ 设置验证器，只能输入数字 |
textColor |
文字颜色, 颜色定义参看 控件对象 |
ui.form-name.singlelineinput-name.textColor=’#ff0000’ 设置文字为红色 |
textAlign |
文字对齐方式： |
ui.form-name.singlelineinput-name.textAlign=’center’ 设置对象文本居中对齐 |
borderColor |
边框颜色，颜色定义参看 控件对象 |
ui.form-name.singleinput-name.borderColor=’#0000ff’ 设置边框为蓝色 |
borderWidth |
边框宽度，单位：像素 |
ui.form-name.singlelineinput-name.borderWidth=5 设置对象边框宽为5个像素 |
borderRadius |
边框拐角弧度半径，单位：像素 |
ui.form-name.singlelineinput-name.borderRadius=8 设置对象边框拐角半径为8个像素 |
borderType |
边框类型。支持0-Inset，1-Outset，2-Dotted，3-Solid，4-No_Border。 |
ui.form-name.singlelineinput-name.borderType=4 设置对象无边框 |
backgroundColor |
背景色，颜色定义参看 控件对象 |
ui.form-name.singlelineinput-name.backgroundColor=’#ff0000’ 设置背景为红色 |
backgroundColorType |
背景色类型：0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle，5-Pure, 6-No_Color |
ui.form-name.singlelineinput-name.backgroundColorType=4 设置form的背景颜色类型为Circle |
readOnlyBackgroundColor |
只读时背景色 |
ui.form-name.singlelineinput-name.readOnlyBackgroundColor=’#0000ff’ 修改只读时背景色为蓝色 |
editingBackgroundColor |
编辑时背景色 |
name.editingBackgroundColor=’#ff0000’ 修改只读时背景色为红色 |
defaultInputMethod |
默认输入法：0-Letter， 1-Number，2-None (隐藏软键盘) |
ui.form-name.singlelineinput-name.defaultInputMethod=1 设置默认输入法为数字键盘 |
inputSyncEnabled |
输入同步，使能后内容更新后自动同步所有语言下的内容为最新。如果App中只有一种语言，可以忽略此属性 |
ui.form-name.singlelineinput-name.inputSyncEnabled=true设置输入同步 |
selectAllWhenFocus |
获得焦点时文字全选中，适用于选中文本框后直接输入新的内容 |
ui.form-name.singlelineinput-name.selectAllWhenFocus=true设置焦点时全选 |
方法
名称 |
功能说明 |
脚本例子 |
|---|---|---|
setText(string, index) |
设置语言环境为index时的文字标识：string为文字字符串，index为语言环境索引值。当通过service.ctl.setLanguage(index)设置对应的语言环境时，该文字字符串自动显示。 |
ui.form-name.singlelineinput-name.setText(‘测试’, 1) 设置语言环境1下的文字标识为’测试’，当切换到语言环境1时，该标识自动显示替代之前的语言环境字符串 |
lastText() |
获取最后一次修改的文字 |
var text = ui.form-name.singlelineinput-name.lastText()获取最后一次修改的文字 |
setFontSize(size) |
设置字体大小 |
ui.form-name.singlelineinput-name.setFontSize(12) 设置字体为12号 |
backspace() |
回退操作，删除最后一个字符 |
ui.form-name.singlelineinput-name.backspace() 删除最后一个字符 |
append(text) |
追加字符串，参数text为字符串，如果最后一个字符为回车，会自动去除 |
ui.form-name.singlelineinput-name.append(‘A’) 在最后面追加一个字符’A’ |
setFocus() |
设置获取输入焦点（但不弹出软键盘） |
ui.form-name.singlelineinput-name.setFocus() 设置获取输入焦点 |
move(x,y) |
移动对象：将对象移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 |
ui.form-name.singlelineinput-name.move(10,10) 移动对象到坐标（10，10） |
resize(width, height) |
设置对象宽和高 |
ui.form-name.singlelineinput-name.resize(30,20) 设置对象宽30像素，高20像素 |