云应用百宝云交互界面专题分析

 第二节：交互界面

   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)
    发送文本消息("_submitview id:"&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)
    发送文本消息("_submitview id:"&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"
        结束
    结束
结束