2017-2-14
SOUI 界面库
用户使用手册
User
启程软件
v2.3.1.1
修订历史
日期
版本
作者
说明
2017/02/14
0.1
启程软件
文档初稿
目 录
1、概述 .......................................................................................................................................................... 1
1.1 SOUI 是什么？ ........................................................................................................................... 1
1.2 SOUI 相对于 DuiEngine 的改进 ........................................................................................... 1
1.3 SOUI 模块结构 ........................................................................................................................... 1
1.4 模块结构图及框架图 ................................................................................................................. 2
2、SOUI 的编译 .......................................................................................................................................... 4
2.1 获取 SOUI 的源代码 ................................................................................................................. 4
2.2 编译 SOUI 界面库 ..................................................................................................................... 5
3、开始使用 SOUI ...................................................................................................................................... 8
3.1 创建 SOUI 项目（手工创建） ................................................................................................ 8
3.1.1 项目环境配置 ................................................................................................................ 8
3.1.2 项目资源准备 .............................................................................................................. 11
3.1.3 开始编码【TODO：不适用新版 SOUI，需更新】 ............................................ 12
3.2 √创建 SOUI 项目（通过向导创建） ................................................................................... 18
3.2.1 SOUI 向导的安装 ....................................................................................................... 18
3.2.2 使用向导创建 SOUI 项目 ......................................................................................... 19
3.3 编辑器 SOUI Editor 使用教程 ............................................................................................. 22
3.3 使用 uiresImporter 生成 uires.idx 及 skin.xml........................................................... 23
4、SOUI 开发说明 .................................................................................................................................... 25
4.1 xml 资源文件定义 .................................................................................................................... 25
4.1.1 init.xml 资源文件 ...................................................................................................... 27
4.1.2 布局(layout)资源文件 ............................................................................................. 32
4.1.3 布局属性 pos2type 及 offset ............................................................................... 38
4.1.4 在 SOUI 中使用线性布局 ......................................................................................... 40
4.2 系统资源管理 ............................................................................................................................ 41
4.3 应用程序中资源的组织 ........................................................................................................... 46
4.3.1 控件默认的系统资源 ................................................................................................. 47
4.3.1 应用程序自定义资源 ................................................................................................. 49
4.4 在 SOUI 中用九宫格拉伸方式显示一个图片资源 ............................................................. 52
4.7 在 SOUI 中使用有窗口句柄的子窗口 .................................................................................. 56
4.8 SOUI 中控件事件的响应......................................................................................................... 62
4.8.1 在 SHostWnd 的派生类中重载 ............................................................................. 62
4.8.2 采用事件订阅的方式响应控件事件 ........................................................................ 63
4.9 SOUI 多语言翻译机制 ............................................................................................................. 64
4.10 自定义控件 ............................................................................................................................. 67
4.10.1 开发自定义控件 ........................................................................................................ 67
4.10.2 绘图对象（ISkinObj）的扩展 ............................................................................. 72
4.10.3 控件的扩展 ............................................................................................................... 77
4.11 在 SOUI 中使用定时器 ........................................................................................................ 80
4.12 在 SOUI 中消息通讯 ............................................................................................................ 83
4.13 使用窗口的 cache 属性加速 SOUI 的渲染...................................................................... 85
4.14 在 SOUI 中实现 PreTranslateMessage ....................................................................... 86
4.15 提高 SOUI 应用程序渲染性能的三种武器 ....................................................................... 87
4.16 在 SOUI 中使用分层窗口 .................................................................................................... 88
4.17 在 SOUI 中的控件注册机制 ................................................................................................ 90
4.18 在 SOUI 中使用代码向窗口中插入子窗口 ....................................................................... 95
4.19 在 SOUI 中使用 LUA 脚本开发界面 ................................................................................. 98
4.20 导出 SOUI 对象到 LUA 脚本............................................................................................108
4.21 在 SOUI 中做事件分发处理 ..............................................................................................117
4.22 在 SOUI 中使用异步通知 ..................................................................................................120
4.23 在 SOUI2.0 中像 android 一样使用资源 .....................................................................124
4.24 两个 SOUI 新控件 ---- SListView 和 SComboView（借用 Andorid 的设计）
...........................................................................................................................................................128
4.25 在 SOUI 中控件属性查询方法 ..........................................................................................131
4.26 √使用 SOUI 的 SMCListView 控件...............................................................................137
4.27 在… … ...................................................................................................................................146
5、控件说明（SOUI） ...........................................................................................................................147
5.1 SWindow 类 ..........................................................................................................................147
5.2 SwndStyle 类 ........................................................................................................................148
5.3 SHostWndAttr 类................................................................................................................149
5.4 静态文本控件 ..........................................................................................................................150
5.5 超链接控件 ..............................................................................................................................150
5.6 按钮/图片按钮控件 ...............................................................................................................151
5.7 图片控件 ..................................................................................................................................151
5.8 动画图片窗口控件 .................................................................................................................152
5.9 线条控件 ..................................................................................................................................152
5.10 复选框控件 ...........................................................................................................................153
5.11 图标控件 ...............................................................................................................................153
5.12 单选框控件 ...........................................................................................................................153
5.13 Toggle 控件 .........................................................................................................................154
5.14 组控件....................................................................................................................................154
5.15 可输入 CommboBox 控件 ..............................................................................................155
5.16 日历控件 ...............................................................................................................................155
5.17 标签控件 ...............................................................................................................................156
5.18 富文本编辑框控件 ...............................................................................................................156
5.19 简单 edit 控件 .....................................................................................................................157
5.20 表头控件 ...............................................................................................................................157
5.21 热键控件 ...............................................................................................................................158
5.22 列表框控件 ...........................................................................................................................158
5.23 列表控件 ...............................................................................................................................159
5.24 滚动条控件 ...........................................................................................................................160
5.25 滑块工具条控件 ...................................................................................................................160
5.26 分割窗口控件 .......................................................................................................................161
5.27 分割窗口控件 .......................................................................................................................161
5.28 Tab 标签页面控件 ...............................................................................................................161
5.29 Tab 控件 ................................................................................................................................162
5.30 树控件....................................................................................................................................163
5.24 按钮控件 ...............................................................................................................................163
5.24 滚动条控件 ...........................................................................................................................164
5.24 SSkinGif 控件 ......................................................................................................................164
5.24 SSkinGradation 控件 .......................................................................................................165
5.24 SSkinImgList 控件.............................................................................................................165
5.24 SSkinScrollbar 控件..........................................................................................................166
5.24 SSkinImgFrame 控件 .......................................................................................................166
5.24 SSkinMenuBorder 控件 ..................................................................................................167
6、常见问题 ..............................................................................................................................................168
6.0 未解决的问题？ .....................................................................................................................168
6.1 模块 utilities 为什么要用 DLL 编译？ .............................................................................168
6.2 为什么在 soui 中加载 JPG 文件失败？ ............................................................................169
7、其它未收录的博客 .............................................................................................................................175
7.1 谈谈 SOUI 与 WTL ...............................................................................................................175
7.2 在 SOUI 中非半透明窗口如何实现圆角窗口？ ...............................................................176
7.3 谈谈 UI 神器-SOUI ...............................................................................................................178
7.4 一种高效的可变行高列表行定位算法 ................................................................................189
附录、帮助手册排版<格式说明>............................................................................................................. 1
博客收录情况： ............................................................................................................................................ 2
END ................................................................................................................................................................ 4
