DuiLib_Faw

描述

此项目是DuiLib的一个个人维护版本，使用Modern C++重写了整个项目。（至少需C++20支持，但部分代码还未完全使用C++20特性）

大众所熟知的DuiLib主分支处于较少更新的状态，几年前的激进更新派DuiLib_Ultimate、DuiLib_Redrain等也渐渐变成了保守派，也降低了更新速度，然而这个优秀的库也渐渐的无法满足当今的需要。

此仓库建立的目的是，对DuiLib做出较激进的更新优化，使得它能更好的满足当今开发的需要。

此项目的更新方式为，一方面项目自身激进的更新，另一方面原分支仓库有更新时，根据需要将更新内容同步至此仓库。

项目使用示例：易大师网络工具箱

此项目目前只支持vs2017环境下编译，如果使用clang、gcc或其他版本编译器需要自行建立项目文件。

使用

第一步：链接dll

动态链接（不推荐）

注意：因将CDuiString替换为std::string，动态链接方式编译将会出现严重的编译警告。我最近我正在尝试解决这个问题

使用动态链接的程序需在程序目录保留DuiLib*.dll，否则程序无法运行。

用法：主程序内引用如下代码

#if (defined _UNICODE) && (defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_64d.lib")
#elif (defined _UNICODE) && (defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_d.lib")
#elif (defined _UNICODE) && (!defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_64.lib")
#elif (defined _UNICODE) && (!defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib.lib")
#elif (!defined _UNICODE) && (defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_64d.lib")
#elif (!defined _UNICODE) && (defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_d.lib")
#elif (!defined _UNICODE) && (!defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_64.lib")
#elif (!defined _UNICODE) && (!defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA.lib")
#endif

静态链接

静态链接具有诸多好处：依赖关系更少、程序体积更小等。极端的追求程序体积可以使用这种链接方式，使用VC_LTL优化项目引用并缩小程序体积，最后使用upx对程序进行压缩。

用法：主程序内引用如下代码

#if (defined _UNICODE) && (defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_64sd.lib")
#elif (defined _UNICODE) && (defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_sd.lib")
#elif (defined _UNICODE) && (!defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_64s.lib")
#elif (defined _UNICODE) && (!defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLib_s.lib")
#elif (!defined _UNICODE) && (defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_64sd.lib")
#elif (!defined _UNICODE) && (defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_sd.lib")
#elif (!defined _UNICODE) && (!defined _DEBUG) && (defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_64s.lib")
#elif (!defined _UNICODE) && (!defined _DEBUG) && (!defined _WIN64)
#    pragma comment (lib, "../lib/DuiLibA_s.lib")
#endif

看需求加入预处理器定义UILIB_STATIC，然后将编译选项分别设置为/MT、/MTd即可。

第二步：增加变量绑定

需将所有的这种代码：

// InitWindow里面
CEditUI *ctrl = dynamic_cast<CEditUI*> (parent->find_control (_T ("ctrl_name")));

替换为：

// 任意位置
BindEditUI ctrl { _T ("ctrl_name") };

// 多窗口推荐传入m_pm，避免出现无法找到控件的问题
BindEditUI ctrl { _T ("ctrl_name"), &m_pm };

需注意：

绑定对象的创建位置不限，既可以在程序运行时绑定，也可以在InitWindow执行完后再绑定
绑定对象在窗口及PaintManager创建前是无法使用的，只有在两者创建完成后才能使用
PaintManager对象不要设置名称，如果必须设置的场合，需要在Bind/BindCtrls.hpp代码中同步修改
BindXxxxxUI对象的使用方式与CXxxxxUI相同，BindXxxxxUI不能new，使用时直接使用->访问CXxxxxUI里的属性或方法

第三步：自定义控件绑定

假设XML节点为<UserCtrl name="ctrl_name" />，那么类名必须风格统一，为CUserCtrlUI；然后在头文件中加入以下代码：

#ifdef DEF_BINDCTRL
DEF_BINDCTRL (UserCtrl);
#endif //DEF_BINDCTRL

大功告成，此时可以用以下代码实现自定义控件绑定

BindUserCtrlUI ctrl { _T ("ctrl_name") };

已更新内容

完善链接方式，针对是否为Unicode、Debug、64位、动态或静态，4种条件16种链接方式做出完善的链接选项
GroupBox边框绘制时自动擦除文字位置，使得不用设置背景色，文字依旧不被边框遮盖
修复容器子元素手动右对齐，方法为子控件加入代码：floatalign="right"
修复Combo控件的SetText功能
新增图片的dest可为负数，当为负数时，位置固定在目标控件的右边。比如Combo控件固定到右边的下拉箭头
修改CDuiString实现方式的底层为faw::String，使得兼容性更强
Label控件新增autocalcheight，效果类似于autocalcwidth
使用std::variant代替STRINGorID
使用std::string_view代替了几乎所有的LPCTSTR
移除了CDuiPoint、CDuiRect、CDuiSize
整理出公共类FawTools，将大部分重复的代码合并
实现控件绑定（经研究发现，因为语言的问题，值绑定的效果不好，所以这儿暂时不考虑，如果有好的建议可以提）
修复Edit控件nativetextcolor属性无效的问题
新增绘图引用，使得指定的背景图等可以动态改变
修复设置背景色时移除图片资源的bug
新增Dynamic属性，避免因caption覆盖内容时，可拖动边框失效的问题
VerticalLayout自动计算高度、HorizontalLayout自动计算宽度

待研究或待添加

实现虚拟列表效果
实现文字阴影效果
图片没有autocalcwidth、autocalcheight
容器不支持根据子元素大小来计算大小
考虑新增Ribbon、Docker、MVC功能

H1N2 / DuiLib_Faw