duilib使用手册

1.简介#

duilib是一个开源 的directui 界面库，使用XML来描述界面风格，界面布局，将界面与逻辑分离，能够快速开发美观的界面。

2.代码下载与编译#

2.1代码下载#

github网址：https://github.com/duilib/duilib
下载后的代码结构如下：

2.2编译#

打开根目录的Duilib.sln，github上的工程是VS2013的，使用VS2017打开时，会提示升级工程，点升级即可。如果没有升级成功，在工程配置中修改如下选项，选择win10的sdk和VS2017的工具集。

按照如下要求修改文件编码，解决由于编码格式的问题会导致vs2017下编码失败的问题。

根据实际需求，选择对应的工程配置，静态库或者动态库，Unicode或者多字节等等。

选择好工程配置之后，编译工程DuiLib即可。
注意：生成duilib静态库时，需要添加预编译宏UILIB_STATIC

3.使用#

3.1库链接与头文件包含#

使用duilib界面库，可以分为动态链接和静态链接两种方式。

1.静态链接
工程配置中添加对duilib.lib静态库的链接，并且添加预定义宏UILIB_STATIC。

2.动态链接
将生成的duilib.dll拷贝到输出文件的同级目录下，同时添加对导入库duilib.lib的静态链接。

3.头文件
将如下标记的文件和文件夹拷贝，使用时包含UIlib.h文件即可。

3.2代码中的使用#

duilib提供了一个封装类WindowImplBase，从该类继承，并重写部分函数即可，详情参考demo代码：

Copy

#include "..\DuiLib\UIlib.h" #ifdef _DEBUG # ifdef _UNICODE # pragma comment(lib, "DuiLib_ud.lib") # else # pragma comment(lib, "DuiLib_d.lib") # endif #else # ifdef _UNICODE # pragma comment(lib, "DuiLib_u.lib") # else # pragma comment(lib, "DuiLib.lib") # endif #endif using namespace DuiLib; class TestFrame : public WindowImplBase { public: TestFrame(){} ~TestFrame(){} virtual CDuiString GetSkinFolder() { return _T(""); } virtual CDuiString GetSkinFile() { return _T("demo.xml"); } virtual LPCTSTR GetWindowClassName(void) const { return _T("TestWindowClass"); } virtual LRESULT OnClose(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, BOOL& bHandled) { PostQuitMessage(0); return 0; } virtual void Notify(TNotifyUI& msg) { if (msg.sType == _T("click")) { if (msg.pSender->GetName() == _T("buttonName1")) { ::MessageBox(NULL, _T("buttonName1 has been clicked"), _T(""), NULL); } } } private: }; int APIENTRY WinMain(HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, LPSTR /*lpCmdLine*/, int nCmdShow) { CPaintManagerUI::SetInstance(hInstance); HRESULT Hr = ::CoInitialize(NULL); if (FAILED(Hr)) return 0; TestFrame* pFrame = new TestFrame(); if (pFrame == NULL) return 0; pFrame->Create(NULL, _T("TestWindow"), UI_WNDSTYLE_FRAME, 0, 0, 0, 0, 0); pFrame->CenterWindow(); ::ShowWindow(*pFrame, SW_SHOW); CPaintManagerUI::MessageLoop(); ::CoUninitialize(); return 0; } 

对应的xml布局文件：

Copy

<?xml version="1.0" encoding="UTF-8"?> <Window size="600,360"> <VerticalLayout bkcolor="0xFF87CEEB"> <Control /> <HorizontalLayout height="40"> <Control /> <Button name="button1" text="button1" width="80" height="40" bkcolor="0xFF228B22" /> <Control /> </HorizontalLayout> <Control /> </VerticalLayout> </Window> 

运行结果：

关于duiliib的详细用法，可以参考源码工程中的demo，基本列举了所有控件的用法，包括各种布局情况。也可以参考博客：
duilib布局详解
duilib属性列表