duilib入门之贴图描述、类html文本描述、动态换肤、Dll插件、资源打包

转载自duilib入门文档


贴图描述:

         Duilib的表现力丰富很大程度上得益于贴图描述的简单强大。Duilib的贴图描述分为简单模式和复杂模式两种。

         简单模式使用文件名做为贴图描述内容,在这种方式下,此图片将会以拉伸方式铺满控件。

         复杂模式使用带属性的字符串表示贴图方式,既支持从文件中加载图片,也可以从资源中加载,具体如下:

         如果是从文件加载,设置file属性,如file='XXX.png',不要写res和restype属性

         如果从资源加载,设置res和restype属性,不要设置file属性

         dest属性的作用是指定图片绘制在控件的一部分上面(绘制目标位置)

         source属性的作用是指定使用图片的一部分

         corner属性是指图片安装scale9方式绘制

         mask属性是给不支持alpha通道的图片格式(如bmp)指定透明色

         fade属性是设置图片绘制的透明度

         hole属性是指定scale9绘制时要不要绘制中间部分

         xtiled属性设置成true就是指定图片在x轴不要拉伸而是平铺,ytiled属性设置成true就是指定图片在y轴不要拉伸而是平铺:

类html文本描述:

         Duilib使用一种经过简化的类html格式文本来描述复杂的图文格式。使用<>或{}符号来标识语法标签,支持标签嵌套,如<l><b>text</b></l>,但是应该避免交叉嵌套,如<l><b>text</l></b>。

          <b>text</b> 表示text的内容使用粗体

          <c #xxxxxx>text</c> 表示text内容使用#xxxxxx颜色,#xxxxxx表示16进制的RGB值

         <f x>text</f> 表示text内容使用x序号的字体

         <i>text</i> 表示text内容使用斜体

          <i x y z> 表示此次插入图片,x表示图片名称,y表示此图片包含几张字图片(可不填,默认值1),z表示当前使用的字图片id(可不填,默认值0)

         <a x>text</a> 表示text内容有链接功能,x表示链接地址(可不填),用法如app:notepad or http:www.xxx.com,此字符串需要在用户程序中解析处理。

         <n> 表示此次换行

          <p x>text</p> 表示text内容是一个段落(从这里开始换行),x表示此段落文字水平距离(可不填)

         <r>text</r> 表示text内容不使用语法标签功能

         <s>text</s> 表示text内容被选中(显示选中的背景颜色)

          <u>text</u> 表示text内容使用下划线

         <x i> 表示从此处向后面移动x个像素值

         <y i> 表示该行高度固定为y个像素值

 

         使用标签功能需要把控件的showhtml属性设置为true。

动态换肤:

         Duilib是一个以贴图为主要表现手段的界面库,实现换肤非常简单,可以通过给控件设置不同的图片来实现换肤,比如给需要换肤的控件调用CControlUI::SetBkImage。但是针对换肤功能,Duilib提供了更为简单的方法,即使用CPaintManagerUI::ReloadSkin。

假设我们给程序创建了两套皮肤,分别打包成skin1.zip和skin2.zip,在程序运行的时候,执行:

         CPaintManagerUI::SetResourceZip(_T("skin2.zip")); // 或者skin1.zip

         CPaintManagerUI::ReloadSkin();

         这样简单的两行代码,就实现了全部窗口从skin1皮肤到skin2皮肤的切换。你也可以随时再次调用上面两行代码,把皮肤切换回去。

插件使用:

         Duilib支持使用外部dll来扩展控件:

         在dll中,只需要实现一个接口CreateControl,如


extern"C" __declspec(dllexport) CControlUI* CreateControl(LPCTSTR pstrType)

{

    if( _tcscmp(pstrType,_T("ButtonEx")) == 0 ) return new CButtonExUI;

    return NULL;

}

          在使用程序中,需要在WinMain函数把插件dll使用CPaintManagerUI::LoadPlugin加载进来,然后就可以和内置控件一样使用了。


int APIENTRYWinMain(HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, LPSTR /*lpCmdLine*/,int nCmdShow)

{

    CManager::SetInstance(hInstance);

   CManager::SetResourcePath(CManager::GetInstancePath());

CManager::LoadPlugin(PLUGINNAME);

// ……

}

资源打包:

         Duilib使用资源打包功能非常简单,在程序开发完成后只需做两个步骤即可:

         进入资源目录,然后使用具备zip压缩功能的软件(如winrar、winzip、7zip等)把布局xml和图片等资源压缩到一个zip文件包里。

         在WinMain函数中CPaintManagerUI::SetInstance(hInstance)的后面加入CPaintManagerUI::SetResourceZip(_T("xxx.zip")),如


int APIENTRYWinMain(HINSTANCE hInstance, HINSTANCE /*hPrevInstance*/, LPSTR /*lpCmdLine*/,int nCmdShow)

{

    CManager::SetInstance(hInstance);

CManager::SetResourcePath(CManager::GetInstancePath());

CPaintManagerUI::SetResourceZip(_T("xxx.zip"));

// ……

}

 

         这样就完成了资源打包功能,发布程序只需要把exe、dll和zip文件带上就行了。有时为了需要,也可以修改.zip为其他扩展名,比如.dat。


上一篇:新一年,你该如何调整企业安全方案?


下一篇:想成为全栈工程师,要做到哪几点?