duilib入门教程

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代码：

#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布局文件：

<?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属性列表