界面-form
描述
界面，是其子控件对象的容器，父对象为ui，子对象为界面中的控件
事件
load: 加载，当切换到非缓存页面（该页面属性cached=0）时触发，事件函数定义：onLoad()
raise: 升载，当切换到缓存页面时（该页面属性cached=1）触发，第一次显示缓存页面时，会触发一次onLoad事件，事件函数定义：onRaise()
userevent: 当订阅了某 用户自定义事件，通过service.ctl.emitEvent(name, value)广播时触发, 事件函数定义: onUserEvent(name,value)，参数name为事件名，value为数据
属性
名称 |
功能说明 |
脚本例子 |
|---|---|---|
x |
x坐标 （只读属性） |
var x = ui.form-name.x; 获取对象的x坐标 |
y |
y坐标 （只读属性） |
var y = ui.form-name.y; 获取对象的y坐标 |
width |
宽 （只读属性） |
var width = ui.form-name.width; 获取对象宽 |
height |
高 （只读属性） |
var height = ui.form-name.width; 获取对象高 |
enabled |
使能：如果选中，所有子界面控件处于激活状态，否则处于“禁止”状态，对所有触摸操作无反应。 |
ui.form-name.enabled=0禁止form中的所有子控件 |
backgroundImage |
背景图片源 |
ui.form-name.backgroundImage=’test.png’设置背景为资源图片test.png |
alwaysOnTop |
置顶：页面如果可见，永远显示在最上层， 此属性为脚本只读 |
var a=ui.form-name.alwaysOnTop读取alwaysOnTop属性并存入变量a |
cached |
隐藏时缓存：页面隐藏时，任然缓存在内存中，在后台运行。否则页面及其所有子控件释放，下次显示该页面时重新初始化所有子控件，该属性默认为0，即不缓存页面。此属性为脚本只读 |
var a=ui.form-name.cached读取cached属性并存入变量a |
verbose |
事件通知：当触发条件满足时，ExpOS主动向device.io.com0发送事件消息。仅当选择device.io.com0通讯协议为script mode时适用。 |
ui.form-name.verbose=1设置form触发条件满足时向device.io.com0发送事件消息 |
backgroundColor |
背景颜色，颜色定义参看 控件对象 |
ui.form-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.backgroundColorType=4设置form的背景颜色类型为Circle |
backgroundColorAlpha |
背景色透明度：0-255. 0 为不透明，255为全透明，如：128为半透明 |
ui.form-name.backgroundColorAlpha=128设置form的背景颜色为半透明 |
方法
名称 |
功能说明 |
脚本例子 |
|---|---|---|
preload() |
预加载页面，但是不显示，脚本这时可访问该页面的子对象 |
ui.form-name.preload()预加载页面到内存中 |
show() |
显示form: 可支持无参数或者一个参数，参数为切换到该form时的动态效果。参数包括”drop”, “slide”, “scale”和”fade”。 |
ui.form-name.show()按默认效果显示form，默认效果是“fade”ui.form-name.show(‘drop’)按“drop”效果显示form |
hide() |
隐藏form： 无参数。如果该页面是缓存页面，即使隐藏，仍存在于内存中，脚本仍然可以访问该对象及子对象。如果为非缓存页面，该页面将从内存中释放，脚本无法访问。 |
ui.form-name.hide()隐藏form，同时显示其他缓存的后台form |
move(x,y) |
移动form：将form原点移动到(x,y)坐标位置，坐标系的原点在屏幕的左上角。 |
ui.form-name.move(10,10)移动form到坐标（10，10） |