描述


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

事件


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

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

属性


名称功能说明脚本例子
enabled使能:如果选中,所有子界面控件处于激活状态,否则处于“禁止”状态,对所有触摸操作无反应。

ui.form-name.enabled=0

禁止form中的所有子控件

geometry几何尺寸:定义页面的原点坐标(X, Y),长和宽
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)