标签-label
描述
文字标签,父对象为ui,无子对象
事件
textchange: 文本内容改变时触发, 事件方法接收定义:onTextChange(text), text表示当前文本字符串
press: 按下,按下时触发。事件方法定义 onPress()
release: 释放,松开时触发。事件方法定义 onRelease()
userevent: 当订阅了某 用户自定义事件,通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value),参数name为事件名,value为数据
属性
名称 |
功能说明 |
脚本例子 |
---|---|---|
geometryLocked |
区域锁定,锁定后控件的位置及大小不能修改 |
无 |
x |
x坐标 (只读属性) |
var x = ui.form-name.label-name.x; 获取对象的x坐标 |
y |
y坐标 (只读属性) |
var y = ui.form-name.label-name.y; 获取对象的y坐标 |
width |
宽 (只读属性) |
var width = ui.form-name.label-name.width; 获取对象的宽 |
height |
高 (只读属性) |
var height = ui.form-name.label-name.width; 获取对象的高 |
marginRight |
右外边距 (只读属性) |
无 |
marginBottom |
底外边距 (只读属性) |
无 |
enabled |
使能:如果选中,对象处于激活状态,否则处于“禁止”状态,对所有触摸操作无反应。 |
ui.form-name.label-name.enabled=0 禁止对象 |
visible |
可见:如果选中,对象可见,否则隐藏 |
ui.form-name.label-name.visible=0 隐藏对象 |
text |
文字标识 |
ui.form-name.label-name.text=’test’ 设置对象的当前语言环境下的文字标识为test |
verbose |
事件通知:当触发条件满足时,ExpOS主动向串口发送事件消息。仅当选择串口通讯协议为script mode时适用。 |
ui.form-name.label-name.verbose=1 设置对象触发的事件有效时向串口发送事件消息 |
textColor |
文字颜色,颜色定义参看 控件对象 |
ui.form-name.label-name.textColor=’#ff0000’ 设置文字为红色 |
textAlign |
文字对齐方式。0-Center, 1-Left,2-Right,3-Top,4-Bottom。 |
ui.form-name.label-name.textAlign=0 设置对象文本居中对齐 |
borderColor |
边框颜色,颜色定义参看 控件对象 |
ui.form-name.label-name.borderColor=’#ff0000’ 设置边框为红色 |
borderWidth |
边框宽度,单位:像素 |
ui.form-name.label-name.borderWidth=5 设置对象边框宽为5个像素 |
borderRadius |
边框拐角弧度半径,单位:像素 |
ui.form-name.label-name.borderRadius=8 设置对象边框拐角半径为8个像素 |
cornerType |
圆角类型:0-AllCorners, 1-TopCorners, 2-BottomCorners |
ui.form-name.label-name.cornerType=1 设置对象边框顶部有圆角 |
borderType |
边框类型:0-Inset,1-Outset,2-Dotted,3-Solid,4-No_Border。 |
ui.form-name.label-name.borderType=4 设置对象无边框 |
backgroundColor |
背景色:设置form的背景颜色 |
无 |
backgroundColorType |
背景色类型:0-Linear_A, 1-Linear_B, 2-Radial_A, 3-Radial_B, 4-Circle, 5-Pure, 6-No_Color可选 |
ui.form-name.label-name.backgroundColorType=4 设置背景颜色类型为Circle |
effect |
显示效果:0-None, 1-Shadow, 2-Blur |
ui.form-name.label-name.effect=1 显示效果为Shadow |
blurRadius |
模糊半径 |
ui.form-name.label-name.blurRadius=2 设置模糊半径为2 |
方法
名称 |
功能说明 |
脚本例子 |
---|---|---|
setFontSize(size) |
设置字体大小 |
ui.form-name.label-name.setFontSize(12) 设置字体为12号 |
setText(string, index) |
设置语言环境为index时的文字标识:string为文字字符串,index为语言环境索引值。当通过service.ctl.setLanguage(index)设置对应的语言环境时,该文字字符串自动显示。 |
ui.form-name.label-name.setText(‘测试’, 1) 设置语言环境1下的文字标识为’测试’,当切换到语言环境1时,该标识自动显示替代之前的语言环境字符串 |
backspace() |
回退操作,删除最后一个字符 |
ui.form-name.label-name.backspace() 删除最后一个字符 |
append(text) |
追加字符串,参数text为字符串 |
ui.form-name.label-name.append(‘A’) 在最后面追加一个字符’A’ |
move(x,y) |
移动对象:将对象移动到(x,y)坐标位置,坐标系的原点在屏幕的左上角。 |
ui.form-name.label-name.move(10,10) 移动对象到坐标(10,10) |
resize(width, height) |
设置对象宽和高 |
ui.form-name.label-name.resize(30,20) 设置对象宽30像素,高20像素 |