控件对象

WeStudio软件设计是完全基于可视化对象,通过WeStudio环境静态设置或脚本动态操作控件对象的属性,方法,事件和动作,实现APP界面和软件功能。控件对象之间有从属关系,即父子关系,最顶层的父对象称为根对象,包括四个(界面-ui, 设备-device, 服务-service, 工具-util,前三个根对象在页面管理区可见):

■ 界面对象 - ui

将不同的界面软件元素抽象为用户控件,如:文本框、按钮、图片、进度条等,一般在用户界面中可见。用户控件允许用户将控件拖拽到页面设计区创建、移动和删除,并且同一控件可以多次使用。系统启动时,根据用户的设计,动态加载和创建界面控件;访问其方法和属性时,必须确保控件所在的页面已经存在(当前页面或者有“隐藏时缓存”属性的页面)。所有的普通界面控件的父对象为页面,页面的父对象为ui。例如,设置页面xxx中的按钮yyy的属性text为“test”, 对应的JavaScript脚本为:

ui.xxx.yyy.text='test'

界面对象的属性一般只支持数字和字符串类型,访问时JS脚本会做自动转换。比较特殊的属性包括:

  • 颜色属性: 支持如下两种方式定义按三原色定义颜色:

    • 16进制:格式为#RRGGBB, 其中RR表示红色,GG表示绿色,BB蓝色, 例如,#FF0000 代表红色, #FFFF00代表黄色
    • 10进制:格式为rgb(r, g, b), 与16进制表示法类似,rgb(255, 0, 0) 表示红色, rgb(255, 255, 0) 代表黄色

    读取相关颜色属性时,系统按16进制方式返回字符串,写入时,用户可选择任何一种方式。

  • 图片属性: 图片是由资源管理器负责管理,要使用一个图片资源,必须把该图片添加到资源管理器中。图片属性为图片名称字符串,无需指定图片路径,WeStudio会自动在资源管理器中查找到,如果要清除图片属性的设置(即无图片),设置成空字符串即可。

■ 设备对象 - device

将硬件相关的功能软件抽象为io设备控件和net设备控件,如串口、触摸屏、背光、蜂鸣器等属性io设备控件,如can, ethernet属于net设备控件。设备控件由于与硬件一一对应,系统启动后自动创建,任何界面和控件可以无条件访问其属性和方法函数实现系统控制。用户只能对设备控件进行设置,而不允许增加、移动和删除。所有设备控件的父对象为device, 例如,向串口com0发送一个字节0x55,对应的JavaScript脚本为:

device.io.com0.write(0x55)

■ 服务对象 - service

将软件相关功能模块抽象为ctl服务控件和data服务控件,如:输入法键盘,有的在用户界面中可见。服务控件不允许用户将控件拖拽到页面设计区创建、移动和删除,并且同一控件只有一个实例(instance)。与设备控件类似,系统启动后自动创建,任何界面和控件可以无条件访问其属性和方法函数实现服务请求。用户只能对服务控件进行设置,而不允许增加、移动和删除。所有服务控件的父对象为service, 例如,设置环境变量xx值为”test“,对应的JavaScript脚本为:

service.data.variable.write('xx','test')

■ 工具对象 - util

将软件相关工具抽象为工具控件,如:shell。与设备,服务控件类似,系统启动后自动创建,任何界面和控件可以无条件访问其属性和方法函数,所有工具控件的父对象为util, 例如,重启系统,对应的JavaScript脚本为:

util.shell.execute('reboot')

四类控件的属性、方法可直接在动作脚本代码中调用,具体用法参看“软件速查表”。

results matching ""

    No results matching ""