nim duilib

nim_duilib 是一个界面库，包含了一整套桌面软件的开发部件，使用C++语言开发。nim_duilib是在NIM_Duilib_Framework库的基础上进行了代码功能完善和扩展，但由于代码结构和资源XML文件的格式均有调整，所以不能直接兼容基于NIM_Duilib_Framework开发的程序，但代码和资源XML迁移的难度不大。您可以直接使用nim_duilib界面库来开发常用的桌面应用，以简化应用程序的UI开发工作。

特色

• 核心特性包括：
  • 通用样式：支持以XML格式描述应用程序的窗口属性、布局属性、控件属性等，方便调整界面元素的位置和大小，较为灵活
  • 控件丰富：包含各种常见的窗口和控件，如图片控件、动画控件、按钮、文本框、列表控件、虚表控件、树控件、颜色选择控件、菜单等
  • 事件驱动：基于消息机制的事件处理，使得UI交互逻辑清晰
  • 皮肤支持：通过XML文件定义皮肤结构，可以轻松改变界面风格
  • 性能优异：界面资源的内存占有率低，使用Skia引擎绘制，后台绘制配置使用CPU绘制或者GPU绘制
• 多种图片格式，支持的图片文件格式有：SVG/PNG/GIF/JPG/BMP/APNG/WEBP/ICO
• 动画图片，支持GIF动画文件、APNG动画文件、WebP动画文件
• 使用Skia作为界面渲染引擎，性能较好，功能丰富，控件的功能扩展较容易
• 支持DPI感知（Unaware、SystemAware、PerMonitorAware、PerMonitorAware_V2四种模式），支持独立设置DPI，支持高清DPI的适配
• 多国语言支持，支持动态多种语言切换，易于实现国际化
• CEF 控件支持

目录

开始

1. 获取项目代码

git clone https://github.com/rhett-lee/nim_duilib

2. 获取skia代码的编译方法和修改的代码（nim_duilib默认使用skia作为绘制引擎，所以先要编译skia）

git clone https://github.com/rhett-lee/skia_compile

3. 编译skia源码：按照skia_compile目录中的Windows下编译skia.md文档中的方法，编译出skia相关的lib文件
   注意事项：skia源码应该与nim_duilib源码位于相同的目录下。
   注意事项：skia源码编译的时候，应使用LLVM编译，程序运行比较流畅；如果使用VS编译，运行速度很慢，界面比较卡。
   检查方法：编译成功以后，在skia/out的子目录下，有生成skia.lib等lib文件

4. 编译nim_duilib：进入 nim_duilib/examples 目录，使用 Visual Studio 2022版本的 IDE 打开 examples.sln，选择编译选项为Debug|x64或者Release|x64，按下 F7 即可编译所有示例程序（编译完成的示例程序位于bin目录中）。

5. 编译附件说明：
   （1）项目中工程的编译环境为Visual Studio 2022版本，如果使用其他版本的Visual Studio编译器，需要手动更新编译工程的属性。
   （2）项目中的工程默认配置是x64的，如果需要编译Win32的程序，在编译skia的时候，也需要启动32位的命令行（x86 Native Tools Command Prompt for VS 2022）
   （3）nim_duilib的代码兼容性默认是支持Win7以上系统，未支持Windows XP；Windows SDK的兼容性配置可在duilib\duilib_config.h文件中修改
   （4）渲染引擎的支持：nim_duilib内部使用Skia作为界面绘制引擎；
   （5）如何配置切换渲染引擎：可修改duilib\Core\GlobalManager.cpp文件顶部的源码来切换渲染引擎。

基于NIM_Duilib_Framework源码做的主要修改

1. 调整了代码的组织结构，按照功能模块划分，大文件按类拆分为多个小文件，有利于理解整个库的体系结构；
2. 梳理了代码的接口文件，补充各个接口的注释和功能注释，有利于阅读和理解代码；
3. 对配置XML文件进行优化，调整了属性命名规则，控件的宽度和高度可以按百分比设置，图片属性增加了部分扩展，优化了图片加载流程；
4. 集成了Skia引擎，并作为默认的渲染引擎；
5. 扩展了图片资源的支持：新增加APNG/WEBP动画，新增对ICO的支持，并优化了图片加载引擎及代码实现逻辑；
6. XML文件解析引擎替换为pugixml parser，性能更优；
7. 对基本数据类型进行了梳理，对控件大小、估算大小、内边距、外边距、颜色、字体等做成基本类型，易于理解和维护；
8. 对布局进行了梳理，归类为：自由布局（浮动布局）、水平布局、垂直布局、水平瓦片布局、垂直瓦片布局、虚表水平布局、虚表垂直布局、虚表水平瓦片布局、虚表垂直瓦片布局，使布局的概念更易理解，易于扩展；
9. 新增加了一些功能控件：

• GroupBox：分组容器
• HotKey：热键控件
• HyperLink：带有超级链接的文字
• IPAddress：IP地址控件
• Line：画线控件
• RichText：格式化文本（类HTML格式）
• Split: 分割条控件/容器
• TabCtrl：多标签控件（类似浏览器的多标签）
• ListCtrl：列表控件（Report/Icon/List三个视图）
• PropertyGrid: 属性表控件，支持文本、数字、复选框、字体、颜色、日期、IP地址、热键、文件路径、文件夹等属性
• ColorPicker：拾色器，独立窗口，其中的子控件，可以单独作为颜色控件来使用
• ComboButton：带有下拉组合框的按钮
• 新增加了ShadowWnd类：是WinImplBase的子类，使用附加阴影窗口实现的基类，实现了创建窗口并附加的功能，提供没有 WS_EX_LAYERED 属性的窗口阴影

10. 完善了原有控件的一些功能：

• 对窗口类（Window）增加了新的属性：的功能进行了完善，提高对DPI自适应、窗口消息的代码容错，代码结构做了调整
• 对窗口类（Window）增加了新的属性：use_system_caption，snap_layout_menu，sys_menu，sys_menu_rect, icon属性，提供使用操作系统默认标题栏的选项，自绘标题栏的功能与系统标题栏的功能相似；
• 对窗口（Window）引入WindowDropTarget辅助类，提供对基于窗口的拖放功能的支持
• 对资源管理相关的部分做了梳理，使得字体、颜色、图片等资源管理更容易理解
• 对ListBox控件进行了优化：细分为ListBox、VListBox、HListBox、VTileListBox、HTileListBox、VirtualListBox、VirtualVListBox、VirtualHListBox、VirtualVTileListBox、VirtualHTileListBox几种，功能更加完善，基于虚表的ListBox功能可用性提升；
• 对组合框（Combo）关联的控件（CheckCombo、FilterCombo）进行了优化，提升可用性
• 对日期时间（DateTime）控件的编辑功能进行了完善
• 对菜单（CMenuWnd）类的功能代码进行优化，按新的结构重新实现菜单，使得菜单内的控件完全兼容现有容器/控件体系，易于理解和维护
• 对富文本编辑控件（RichEdit）进行功能优化和扩展，丰富了较多常用功能
• 对树控件（TreeView）进行功能优化和扩展，丰富了较多常用功能，提升可用性
• 全局资源（GlobalManager）的接口进行了优化，使得所有资源全部通过此接口管理，易于理解和维护
• 同一个窗口内的不同容器之间，容器内的控件可以通过属性设置支持拖出和拖入操作
• 控件的背景色支持渐变色
• 完善了多国语言的功能，能够更好的支持多语言动态切换，并提供示例程序examples/MultiLang
• 完善了DPI感知功能，支持Unaware、SystemAware、PerMonitorAware、PerMonitorAware_V2四种模式，支持独立设置DPI，支持高清DPI的适配，提供了示例程序examples/DpiAware

11. 性能优化：

• 优化了Control及子控件的内存占用，在界面元素较多的时候，内存占有率有大幅降低；
• 优化了动画绘制流程，合并定时器的触发事件，避免播放控件动画或者播放动画图片的过程中导致界面很卡的现象
• 基于虚表的ListBox控件及关联控件：通过优化实现机制，使得可用性和性能有较大改善

12. 示例程序完善：

• examples/ColorPicker: 新增加了拾色器示例程序
• examples/ListCtrl：新增加了列表的示例程序，演示列表的个性功能
• examples/render：新增加了渲染引擎示例程序，演示了大部分容器、控件、资源管理的功能
• examples/TreeView：新增加了树控件的示例程序，演示了树控件的各种功能
• examples/RichEdit：新增加了富文本编辑控件的示例程序，演示了富文本编辑控件的各种功能
• examples/MultiLang：提供多语言的动态切换功能演示
• examples/DpiAware：提供了DPI感知功能的功能演示
• 其他的示例程序：大部分进行了代码兼容性修改和优化，使得示例程序也可以当作测试程序使用；

13. 文档的完善：

• README.md和docs子目录的文档重新进行了梳理，使得阅读者更容易理解界面库的功能、用法，更易上手
• 各个控件的接口没有单独整理成文档，因为可以直接阅读接口文件中的注释来达到目的，目前各个接口的注释是比较完善的

14. 减少依赖

• 移除对base库的依赖，消息循环和线程通信相关功能改为自己实现

使用的第三方库说明

备注：

1. 本项目最早是基于duilib开发的，项目地址：duilib
2. 本项目是直接在NIM_Duilib_Framework项目的基础上继续开发的，项目地址：NIM_Duilib_Framework

开发计划

• 窗口的封装优化：支持跨平台的窗口引擎
  （目前正在开发基于SDL3.0的作为窗口管理器的方案，可实现界面库的跨平台的支持）
  （相关的进度参见文档：跨平台开发相关事项.md）
• 动画功能的加强
• 不断测试发现缺陷并修复，不断完善代码
• 其他待补充

参考文档

• 快速上手
• 参考文档
• 示例程序