页面-form

描述


页面,是其子界面控件对象的容器,父对象为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背景色类型:linear-1,linear-2,radial-1,radial-2, circle,pure, none可选

ui.form-name.backgroundColorType='circle'

设置form的背景颜色类型为circle

backgroundColorAlpha背景色透明度:0-255. 0 为不透明,255为全透明,如:128为半透明

ui.form-name.backgroundColorAlpha=128

设置form的背景颜色为半透明

方法

名称功能说明脚本例子
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)

dispatchEvent(event)

触发事件脚本执行:如果控件设置该触发事件为有效,相关脚本会被执行。event的值可为“onLoad”和“onRaise”。

ui.form-name.dispatchEvent('onLoad')

触发form的”onLoad“事件脚本执行

 


下一页