【界面ui-开发者文档】

admin

界面dll目前仅支持易语言，你可以使用黑月编译或静态编译，推荐黑月编译，黑月编译可以让易语言代码转换为c++代码然后进行编译，不过这就要求自绘窗口了，难度偏大

①：添加模块sdk

②创建标准SDK接口

  

子程序名	返回值类型	公开	备 注
main		√	初始化
参数名	类 型	参考	可空	数组	备 注
局参_响应指针	子程序指针
界面是否可见	逻辑型

未闻花名_界面_初始化 (局参_响应指针)
界面自定义.界面是否可见 ＝ 界面是否可见
界面自定义.程序标题 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_程序标题]”, “”)
界面自定义.界面类型 ＝ 未闻花名_界面_整数值判断 (“[未闻花名界面_整数型_界面类型（1为单码，2为账号密码，默认为1）]”, 1)
界面自定义.注册_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_注册界面使用的凭证]”, “注册凭证”)
界面自定义.修改密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_修改密码界面使用的凭证]”, “修改密码凭证”)
界面自定义.找回密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_找回密码界面使用的凭证]”, “找回密码凭证”)
判断 (界面自定义.界面类型 ＝ 1)
卡密_启动 ()

登陆窗口_启动 ()

子程序名	返回值类型	公开	备 注
display		√	是否可见
参数名	类 型	参考	可空	数组	备 注
是否可见	逻辑型

判断 (界面自定义.界面类型 ＝ 1)
登录窗口_是否可见 (是否可见)

判断 (界面自定义.界面类型 ＝ 2)
卡密窗口_显示 (是否可见)

子程序名	返回值类型	公开	备 注
OpenSelect	整数型	√	弹出选择提示，点击确认返回1，其他情况返回0
参数名	类 型	参考	可空	数组	备 注
标题	文本型
提示内容	文本型

变量名	类 型	静态	数组	备 注
选择项	整数型

判断 (界面类型 ＝ 1)
选择项 ＝ 单码_弹出选择提示 (标题, 提示内容)

判断 (界面类型 ＝ 2)
选择项 ＝ 注册码_弹出选择提示 (标题, 提示内容)




返回 (选择项)

.版本 2<br /> <br /> .子程序 main, , 公开, 初始化<br /> .参数 局参_响应指针, 子程序指针<br /> .参数 界面是否可见, 逻辑型<br /> <br /> 未闻花名_界面_初始化 (局参_响应指针)<br /> <br /> 界面自定义.界面是否可见 ＝ 界面是否可见<br /> 界面自定义.程序标题 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_程序标题]”, “”)<br /> 界面自定义.界面类型 ＝ 未闻花名_界面_整数值判断 (“[未闻花名界面_整数型_界面类型（1为单码，2为账号密码，默认为1）]”, 1)<br /> 界面自定义.注册_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_注册界面使用的凭证]”, “注册凭证”)<br /> 界面自定义.修改密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_修改密码界面使用的凭证]”, “修改密码凭证”)<br /> 界面自定义.找回密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_找回密码界面使用的凭证]”, “找回密码凭证”)<br /> <br /> <br /> .判断开始 (界面自定义.界面类型 ＝ 1)<br />     卡密_启动 ()<br /> <br /> .默认<br />     登陆窗口_启动 ()<br /> <br /> .判断结束<br /> <br /> <br /> .子程序 display, , 公开, 是否可见<br /> .参数 是否可见, 逻辑型<br /> <br /> .判断开始 (界面自定义.界面类型 ＝ 1)<br />     登录窗口_是否可见 (是否可见)<br /> <br /> <br /> .判断 (界面自定义.界面类型 ＝ 2)<br />     卡密窗口_显示 (是否可见)<br /> <br /> .默认<br /> <br /> .判断结束<br /> <br /> <br /> .子程序 OpenSelect, 整数型, 公开, 弹出选择提示，点击确认返回1，其他情况返回0<br /> .参数 标题, 文本型<br /> .参数 提示内容, 文本型<br /> .局部变量 选择项, 整数型<br /> <br /> .判断开始 (界面类型 ＝ 1)<br />     选择项 ＝ 单码_弹出选择提示 (标题, 提示内容)<br /> <br /> <br /> .判断 (界面类型 ＝ 2)<br />     选择项 ＝ 注册码_弹出选择提示 (标题, 提示内容)<br /> <br /> <br /> .默认<br /> <br /> .判断结束<br /> <br /> <br /> 返回 (选择项)

提示：
这3个接口是必须的，且不可改变其名称，参数的数量不可增加或减少，接下来来解释每个函数的用法

main
控制的是全局初始化数据，当用户的响应程序启动的时候，首先调用的便是本函数，因此你程序所有的初始化效果都应当在这里面写

  

未闻花名_界面_初始化 (局参_响应指针)

未闻花名_界面_初始化 (局参_响应指针)

这句代码是必须的，没有这句代码dll无法向响应程序主动发送请求（比如登录按钮被单击，公告被打开等信息都无法传递给响应程序）

  

界面自定义.界面是否可见 ＝ 界面是否可见
界面自定义.程序标题 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_程序标题]”, “”)
界面自定义.界面类型 ＝ 未闻花名_界面_整数值判断 (“[未闻花名界面_整数型_界面类型（1为单码，2为账号密码，默认为1）]”, 2)
界面自定义.注册_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_注册界面使用的凭证]”, “注册凭证”)
界面自定义.修改密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_修改密码界面使用的凭证]”, “修改密码凭证”)
界面自定义.找回密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_找回密码界面使用的凭证]”, “找回密码凭证”)

界面自定义.界面是否可见 ＝ 界面是否可见<br /> 界面自定义.程序标题 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_程序标题]”, “”)<br /> 界面自定义.界面类型 ＝ 未闻花名_界面_整数值判断 (“[未闻花名界面_整数型_界面类型（1为单码，2为账号密码，默认为1）]”, 2)<br /> 界面自定义.注册_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_注册界面使用的凭证]”, “注册凭证”)<br /> 界面自定义.修改密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_修改密码界面使用的凭证]”, “修改密码凭证”)<br /> 界面自定义.找回密码_凭证 ＝ 未闻花名_界面_文本值判断 (“[未闻花名界面_文本型_找回密码界面使用的凭证]”, “找回密码凭证”)

这些代码的意思是给用户提供界面选择，看下面这张图你就懂了


子程序的第2个参数是默认值，当用户未填写时默认使用该值

这5个参数是必须要的基本设置，当然，你也可以根据自己的需要去进行添加选择

重点提示：main这个子程序的第2个参数是界面是否可见，也就是说，你的界面创建后是否可见要通过这个参数来确定

display
这个子程序就比较好理解了，这个子程序就是用于设置你界面的可视属性的


OpenSelect
这条函数的目的是弹出一个选择框


选择框需要具有是和否2个选择按钮，用户点击确认按钮时返回1，其他情况返回0（点击取消按钮或关闭提示弹窗）

③响应触发时的传达

所谓的响应就是，用户单击了登录按钮，注册按钮，充值按钮等

注册，充值，修改密码，找回密码，这4个的写法都是基本一致的

  

子程序名	返回值类型	公开	备 注
_图形按钮_注册_被单击

返回值 ＝ 未闻花名_界面_用户注册 (编辑框_注册_用户名.内容, 编辑框_注册_用户密码.内容, 编辑框_注册_凭证.内容)
_msg (登陆窗口, 返回值, 0, )

子程序名	返回值类型	公开	备 注
_图形按钮_充值_被单击

返回值 ＝ 未闻花名_界面_用户充值 (编辑框_充值_用户名.内容, 编辑框_充值_充值卡密.内容)
_msg (登陆窗口, 返回值, 0, )

子程序名	返回值类型	公开	备 注
_图形按钮_改密_被单击

返回值 ＝ 未闻花名_界面_修改密码 (编辑框_修改密码_用户名.内容, 编辑框_修改密码_凭证.内容, 编辑框_修改密码_新密码.内容)
_msg (登陆窗口, 返回值, 0, )

子程序名	返回值类型	公开	备 注
_图形按钮_找回密码_被单击

返回值 ＝ 未闻花名_界面_找回密码 (编辑框_找回密码_用户名.内容, 编辑框_找回密码_凭证)
_msg (登陆窗口, 返回值, 0, )

.版本 2<br /> <br /> .子程序 _图形按钮_注册_被单击<br /> <br /> <br /> 返回值 ＝ 未闻花名_界面_用户注册 (编辑框_注册_用户名.内容, 编辑框_注册_用户密码.内容, 编辑框_注册_凭证.内容)<br /> <br /> _msg (登陆窗口, 返回值, 0, )<br /> <br /> .子程序 _图形按钮_充值_被单击<br /> <br /> 返回值 ＝ 未闻花名_界面_用户充值 (编辑框_充值_用户名.内容, 编辑框_充值_充值卡密.内容)<br /> <br /> <br /> _msg (登陆窗口, 返回值, 0, )<br /> <br /> .子程序 _图形按钮_改密_被单击<br /> <br /> 返回值 ＝ 未闻花名_界面_修改密码 (编辑框_修改密码_用户名.内容, 编辑框_修改密码_凭证.内容, 编辑框_修改密码_新密码.内容)<br /> <br /> <br /> _msg (登陆窗口, 返回值, 0, )<br /> <br /> .子程序 _图形按钮_找回密码_被单击<br /> <br /> 返回值 ＝ 未闻花名_界面_找回密码 (编辑框_找回密码_用户名.内容, 编辑框_找回密码_凭证)<br /> <br /> _msg (登陆窗口, 返回值, 0, )

就是简单的调用模块的子程序并获得返回值，然后将返回值以弹窗等形式展示出来

对于登录的设计则会有所不同

  

子程序名	返回值类型	公开	备 注
_登录_被单击

变量名	类 型	静态	数组	备 注
卡密	文本型

卡密 ＝ 编辑框_单码卡密.内容
写配置项 (配置路径, 节名称, “单码卡密”, 卡密)
返回值 ＝ 未闻花名_界面_卡密登录 (卡密)
判断 (返回值 ＝ #常量_未闻花名_不执行 )
返回 ()




_msg (卡密窗口, 返回值, 0)

.版本 2<br /> <br /> .子程序 _登录_被单击<br /> .局部变量 卡密, 文本型<br /> <br /> 卡密 ＝ 编辑框_单码卡密.内容<br /> 写配置项 (配置路径, 节名称, “单码卡密”, 卡密)<br /> <br /> 返回值 ＝ 未闻花名_界面_卡密登录 (卡密)<br /> <br /> .判断开始 (返回值 ＝ #常量_未闻花名_不执行)<br />     返回 ()<br /> <br /> .默认<br /> <br /> .判断结束<br /> <br /> _msg (卡密窗口, 返回值, 0)

登录的设计中多了一个判断，因为当响应程序判断登录成功的时候，就直接载入功能窗口了，这个时候会返回常量_未闻花名_不执行，以此来告诉界面不需要再弹出提示了

重点提示：
你的界面不允许直接被关闭


当点击你窗口上的关闭的时候，这个窗口不允许被关闭，应该要将这个触发提交给响应程序

  

子程序名	返回值类型	公开	备 注
_按钮_关闭_被单击

未闻花名_界面_关闭 ()

.版本 2<br /> <br /> .子程序 _按钮_关闭_被单击<br /> <br /> 未闻花名_界面_关闭 ()