单行输入框-singlelineinput

描述

单行文本输入框,父对象为ui,无子对象


事件

  • textchange: 文本框文本发生变化时触发。事件函数定义: onTextChange(text),参数text为新的文本值
  • editfinish:当按下输入键盘OK按钮时触发。事件函数定义: onEditFinish()
  • editcancel:当按下输入键盘Cancel按钮时触发。事件函数定义: onEditCancel()
  • focusin:当文本框获得输入焦点时触发。事件函数定义: onFocusIn()
  • userevent: 当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value),参数name为事件名,value为数据

属性

名称 功能说明 脚本例子
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; 获取对象的高
enabled 使能:如果选中,对象处于激活状态,否则处于'禁止"状态,对所有触摸操作无反应。 ui.form-name.singlelineinput-name.enabled=0 禁止对象
visible 可见:如果选中,对象可见,否则隐藏 ui.form-name.singlelineinput-name.visible=0 隐藏对象
verbose 事件通知:当触发条件满足时,ExpOS主动向device.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.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像素

results matching ""

    No results matching ""