牛牛安装包界面控件使用说明.doc

牛牛安装包界面控件使用说明本说明文档旨在对控件的使用进行说明,指导调用者顺利的将牛捉安装包界面控件控件集成进安装包中,使第三方产品也能拥有完美的安装包的体验功能。官方网址:牛牛安装包界面控件是一个可集成于的插件,采用开发,在使用时,安装包制作者只需要做如下两件事情:.通过配置的资源,,通过脚本调用的相关接口,集成及安装包的业务功能在控件的资源中,采用的是通过控件来实现不同阶段的安装界面,比如:选择路径、许可协议、安装进度、完成、卸载等,在实际使用中,通过脚本来设置当前需要显示的页,即可完美的呈现出需要的界面了。在我们的示例中,提供了两份安装的界面如下:注意,最新版本的控件已经将可用的及的相关文件包含在示例包中,可以通过一键打包批处理脚本进行打包了,具体如下:).将要打包的文件复制到目录下,可以包含文件及若干层的目录).修改相关项目下的目录下的资源文件及脚本来配置).添加相关(或者在我原来的示例上修改,这样更快)的脚本文件,并与相匹配).指定好相关的、等信息).执行脚本,一键打包,脚本会做三件事:将目录下的文件打包成;将目录下的文件打包成;调用编译程序,编译文件,输出安装包。以上描述的脚本为全自动执行,可以轻松集成进您现有的软件发布流程中,实现自动化打包发布。牛牛安装包界面控件包含的接口较多,以下逐一进行介绍[以下接口调用及参数说明按在脚本中的调用示例来说明]::"$\""${}"参数说明:参数序号参数类型参数说明备注字符串用于指定安装包的插件释放路径此路径的指定非常重要,在脚本中指定的插件以及资源包将会释放至此目录下,只有正确指定后,界面控件才能调用资源显示窗口字符串许可协议的文件名这是一个文档,在界面控件加载时,将会加载此文件来显示许可协议重新设置许可协议的文件名$""设置后,许可协议显示控件将会重新加载许可协议文件,这个比较适合用于多语言版本的不同许可协议加载显示。设置安装包标题此接口函数用于指定安装包的标题。调用示例:$"${}安装程序"参数说明:参数序号参数类型参数说明备注整型用于指定要设置标题的窗口句柄调用时返回(可传递子窗口弹窗口的句柄)字符串用于指定安装包的标题设置当前显示的页$""${}参数序号参数类型参数说明备注整型用于指定要设置标题的窗口句柄调用时返回(可传递子窗口弹窗口的句柄)字符串指定的控件的需要显示的页序号以为初始值路径选择相关接口通知接口来浏览安装路径$通知界面控件来浏览安装路径,并且将路径获取到变量中。再调用此接口后,应该再调用接口来将安装的路径设置到控件界面上。通知接口来浏览安装路径扩展接口$"请选择安装路径"$此接口是的扩展接口,在的基础上,支持设置文件选择框的标题。显示界面控件当界面绑定事件完成后,通过此接口来调用显示控件,此接口将会阻塞运行。参数序号参数类型参数说明备注整型用于指定显示前要回调的函数如果为,则表示不回调弹出提示框接口)以下代码用于初始化子窗口弹窗,同时返回其句柄:""""""$参数序号参数类型参数说明备注字符串指定弹窗要用到的配置文件字符串指定点击后弹窗退出时返回的按钮号如果使用绑定了此按钮回调的函数,则此设置失效字符串指定点击后弹窗退出时返回的按钮号如果使用绑定了此按钮回调的函数,则此设置失效)以下代码用于根据弹窗窗口的句柄设置其控件的属性,控制显示变化:$"""""提示")以下代码将弹窗显示出来:参数说明:参数序号参数类型参数说明备注整型指定显示弹窗前要回调的函数地址如果为表示不回调;指定界面上指定控件的属性$""""""$"""""正在卸载..."此接口用于指定界面的指定元素的指定属性,比如:是否可用、是否可见、是否选中、文字、背景图等等参数说明:参数序号参数类型参数说明备注整型用于指定要设置标题的窗口句柄调用时返回(可传递子窗口弹窗口的句柄)字符串控件的字符串控件的属性名字符串控件的属性值注:可以通过此接口设置所有的通用属性;一般可以利用此接口来设置指定控件的文本、是否可用、是否可见、位置、大小、背景图、文本颜色等;比如可以用于设置复选框是否选中等等。通用的属性列表项可以参照下图:设置示例如下:获取控件的通用属性$""""$此接口用于获取界面的指定元素的指定属性,比如:是否可用、是否可见,文本等等参数说明:参数序号参数类型参数说明备注整型用于指定要设置标题的窗口句柄调用时返回(可传递子窗口弹窗口的句柄)字符串控件的字符串控件的属性名注:通用的属性列表项可以参照下图:绑定上控件的相关事件$$""$此接口用于绑定一个按钮点击的回调函数或一个控件的文字变化时的回调函数。参数说明:参数序号参数类型参数说明备注整型用于指定要设置标题的窗口句柄调用时返回(可传递子窗口弹窗口的句柄)字符串界