第二节:交互界面
2.1发送配置系列命令
在百宝云里,有一系列函数可以向云应用发送配置消息,之后在云应用的界面里会出现配置信息。命令有如下这些:
发送配置界面的命令 | 命令描述 |
sendconfigcheckbox发送多选配置 | 发送多选框消息到百宝云app |
sendconfigconfirm发送确认配置 | 发送确认消息到百宝云app |
sendconfiginput发送输入配置 | 发送输入框消息到百宝云app |
sendconfigradio发送单选配置 | 发送单选框消息到百宝云app |
sendconfigstatic发送文本配置 | 发送文本框消息到百宝云app |
例如:
//按下主按钮触发函数方法
功能_mainbutton()
发送确认框配置("编号1","这是一个确认配置","abc","copy")
结束
在
主按钮的事件里,调用发送确认框配置命令,当点击主按钮的时候,会出现下面这样的内容。
备注,如下情况表示消息还未处理。
点击箭头区域,会跳转到配置界面。如下:
点击【是】与【否】按钮之后,根据_submitconfig函数里的处理,得到相应的结果。
2.2界面处理函数(_submitconfig)
在配置界面里,点击界面中的任何一个控件,_submitconfig函数都将被执行。通过此函数,可以实现多级界面之间的切换。
事件函数原型:
_submitconfig(id,value)
id[字符型]:配置相关函数中的,配置编号,也就是app交互界面中的界面id
value[字符型]:app交互界面中,用户操作点击的选项值
例如下面完整代码:
//程序入口函数
功能_initial()
发送文本消息("_initial")
结束
//按下主按钮触发函数方法
功能_mainbutton()
发送确认框配置("编号1","这是一个确认配置","abc","copy")
结束
功能_loadconfig()
变量arr=数组("checkbox","input","confirm","radio","static","exit")
变量ret=格式化单选框配置("编号1",arr,"控件测试")
返回ret
结束
功能_submitconfig(id,value)
发送文本消息("_submitviewid:"&id&"value:"&value)
如果(id=="编号1")
如果(value=="yes")
发送文本消息("你点击了[是]按钮!")
返回"exit"
否则如果(value=="no")//点击exit内容
发送文本消息("你点击了[否]按钮!")
返回"exit"
结束
结束
结束
2.3配置界面入口函数(_loadconfig)
在云应用里点击配置界面按钮时,_loadconfig()函数被调用,加载主配置界面。例如下面代码:
功能_loadconfig()
变量arr=数组("checkbox","input","confirm","radio","static","exit")
变量ret=格式化单选框配置("编号1",arr,"控件测试")
返回ret
结束
当
点击云应用里的配置按钮时:
在此界面,点击其中任意控件,都将触发_submitconfig函数,以便用户处理相应控件的事件。
2.4多级界面实现方法
百宝云配置界面里支持多级界面,而且还可以返回上一级界面,但是在编写代码时,一定要注意如下几点:
Ø界面的方法必须是以config_开头。
Ø界面的方法必须有返回语句。
Ø返回语句里的内容必须是界面格式化后的字符串,一般使用格式化配置系列命令返回的字符串。
Ø如果没有返回语句或者是返回的字符串格式不对,都会出现界面加载失败。
Ø返回exit表示退出app的配置界面。
例如在上面的示例基础上增加一级界面。代码如下:
//程序入口函数
功能_initial()
发送文本消息("_initial")
结束
//按下主按钮触发函数方法
功能_mainbutton()
发送确认框配置("编号1","这是一个确认配置","abc","copy")
结束
功能_loadconfig()
变量arr=数组("checkbox","input","confirm","radio","static","exit")
变量ret=格式化单选框配置("编号1",arr,"控件测试")
返回ret
结束
//打开一个文本框的界面
功能config_文本界面()
返回格式化文本框配置("编号1","这是一个文本配置")
结束
//打开一个输入框的界面
功能config_输入界面()
返回格式化输入框配置("编号1","这是一个输入配置,请输入信息")
结束
//打开一个拥有5个选项的单选框界面
功能config_单选界面()
变量arr=数组()
遍历(变量i=0;i<5;i++)
关联数组追加元素(arr,"选项"&i)
结束
变量ret=格式化单选框配置("单选框",arr,"这是一个单选配置")
返回ret
结束
//打开一个确认的界面
功能config_确认界面()
返回格式化弹出框配置("编号1","这是一个确认配置")
结束
//打开一个拥有4个选项的复选框界面
功能config_多选界面()
变量arr=数组("选项1","选项2","选项3","选项4")
变量ret=格式化多选框配置("编号2",arr,"这是一个多选配置")
返回ret
结束
功能_submitconfig(id,value)
发送文本消息("_submitviewid:"&id&"value:"&value)
如果(id=="编号1")
如果(value=="static")//点击static内容
返回"config_文本界面"
否则如果(value=="checkbox")//点击checkbox内容
返回"config_多选界面"
否则如果(value=="input")//点击input内容
返回"config_输入界面"
否则如果(value=="confirm")//点击confirm内容
返回"config_确认界面"
否则如果(value=="radio")//点击radio内容
返回"config_单选界面"
否则如果(value=="exit")//点击exit内容
返回"exit"
结束
如果(value=="yes")
发送文本消息("你点击了[是]按钮!")
返回"exit"
否则如果(value=="no")//点击exit内容
发送文本消息("你点击了[否]按钮!")
返回"exit"
结束
结束
结束