Skip to content

页面-Form

描述


页面,是其子界面控件对象的容器,父对象为ui,子对象为界面中的控件

事件


onLoad: 加载,当切换到非缓存页面(该页面属性cached=0)时触发。

onRaise:升载,当切换到缓存页面时(该页面属性cached=1)触发,第一次显示缓存页面时,会触发一次onLoad事件。

onUserEvent: 接收自定义事件,当订阅了某自定义事件,通过service.emitEvent(name, value)广播时触发。

属性


名称功能说明脚本例子
xx坐标 (只读属性)var x = ui.form-name.x; 获取对象的x坐标
yy坐标 (只读属性)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.com0发送事件消息。仅当选择device.com0通讯协议为script mode时适用。ui.form-name.verbose=1设置form触发条件满足时向device.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)