第二节:交互界面
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" 结束 结束 结束