SOUI2.0之前,在SOUI中使用资源通常是直接使用这个资源的name(一个字符串)来引用。使用字符串的好处在于字符串能够表达这个资源的意义,因此使用字符串也是现代UI引擎常用的方式。
尽管直接使用字符串有意义明确的优点,它同样也有缺点:
1、字符串写错了,编译器不知道。这可能导致一些很难发现的BUG。
2、控件查询,比较时基于字符串,相对来说性能会差一点(好在现在CPU够强,这点性能损失通常可以忽略)。
做过Android开发的朋友可能知道,在Android中要引用一个资源如图片、字符串、颜色等可以使用R.id.xxx, R.string.xxx,R.color.xxx这样的形式来引用。
Android内部全部自动转换成ID,整数比较显然比字符串比较快,这里不作讨论。
这种方式一个好处在于Android的自动补全功能能够帮助你快速的输入你需要的资源,除了加快了编码速度,还大大减少了输入错误。
SOUI2.0把Android的这种资源引用方式引入了进来。
关键在于uiresbuilder。原来SOUI中的uiresbuilder只提供将资源转换成.rc2功能,方便将资源编译到EXE/DLL中。
2.0版本新增加name提取,id生成,字符串表ID生成,颜色表ID生成功能。它们会输出到一个C++头文件(由命令行参数指定)。
要使用该功能首先要保证所有的布局XML所在的资源类型为"Layout",然后在uiresbuilder的命名行中加入: -h “输出文件名” idtable。-h 后面紧跟输出文件名,idtable指示需要给没有指定ID的控件自动生成ID,该功能默认关闭。
生成成功后,你的“输出文件”的内容可能是下面的样子:
//stamp:0ae7b68801b8deb8
/*<------------------------------------------------------------------------------------------------->*/
/*该文件由uiresbuilder生成,请不要手动修改*/
/*<------------------------------------------------------------------------------------------------->*/
#pragma once
#include <res.mgr/snamedvalue.h>
namespace SOUI
{
const SNamedID::NAMEDVALUE namedXmlID[]={
{L"btnSelectGif",},
{L"btn_display",},
{L"btn_hidetst",},
{L"btn_lrc",},
{L"btn_menu",},
{L"ctrl_flash",},
{L"gif_test",},
{L"giftest",},
{L"tab_main",} };
class _R{
public:
class _name{
public:
_name(){
btnSelectGif = namedXmlID[].strName;
btn_display = namedXmlID[].strName;
btn_hidetst = namedXmlID[].strName;
btn_lrc = namedXmlID[].strName;
btn_menu = namedXmlID[].strName;
ctrl_flash = namedXmlID[].strName;
gif_test = namedXmlID[].strName;
giftest = namedXmlID[].strName;
tab_main = namedXmlID[].strName;
}
const wchar_t * btnSelectGif;
const wchar_t * btn_display;
const wchar_t * btn_hidetst;
const wchar_t * btn_lrc;
const wchar_t * btn_menu;
const wchar_t * ctrl_flash;
const wchar_t * gif_test;
const wchar_t * giftest;
const wchar_t * tab_main;
}name; class _id{
public:
const static int btnSelectGif = ;
const static int btn_display = ;
const static int btn_hidetst = ;
const static int btn_lrc = ;
const static int btn_menu = ;
const static int ctrl_flash = ;
const static int gif_test = ;
const static int giftest = ;
const static int tab_main = ;
}id; class _string{
public:
const static int mccol_1 = ;
const static int mccol_2 = ;
const static int mccol_3 = ;
const static int mccol_4 = ;
const static int mccol_5 = ;
const static int mccol_6 = ;
const static int title = ;
const static int ver = ;
}string; class _color{
public:
const static int blue = ;
const static int gray = ;
const static int green = ;
const static int red = ;
const static int white = ;
}color; }; const _R R;
}
第一行保留的是一个时间戳,如果资源中布局相关的资源没有变化,则不再生成。
首先会自动生成一个name, id映射表:SNamedID::NAMEDVALUE,这是一个结构体数组,保留每一个控件的名字及ID(自动生成的及XML中定义的,自动生成的ID自动从65536开始,因此自己定义时应该小于这个值)。
接下来定义了一个类 class _R。_R中有4个子类:_name, _id, _string, _color,每个类有一个实例,对应的名字为:name, id, string, color。
最后定义一个_R的实例R。
到这里你应该已经知道在SOUI中R这个对象有哪几个成员了。
那么在代码中如何使用R这个对象呢?
如何使用name对象:
观察R这个对象,你可能已经发现,在代码直接使用R.name.btnSelectGif就等价于在代码中输入L“btnSelectGif”,这样的好处在于你在输入R.name.btn后VS或者VA可能就给你补全后面的SelectGif,既提高了编码效率,又保证了不会出错。(对象name修改以后也可以使用VA的变量重命名功能自动批量修改)。
如何使用ID对象:
前面提到使用字符串来查找窗口对象相对来说较ID比较会慢一点,那么如何使用ID对象呢?要使用ID对象,有一个要求:由于自动生成的ID并没有修改到原有的XML中,直接从XML中初始化布局时是没有ID属性的。为此SOUI2.0的SApplication对象增加了一个方法:InitXmlNamedID,参见demo(注意调用位置):
//如果需要在代码中使用R::id::namedid这种方式来使用控件必须要这一行代码:2016年2月2日,R::id::namedXmlID是由uiresbuilder 增加-h .\res\resource.h idtable 这3个参数后生成的。
theApp->InitXmlNamedID(namedXmlID,ARRAYSIZE(namedXmlID),TRUE);
在布局创建前给App对象初始化一个自动生成的Name转ID表。
控件创建并初始化name属性时,自动从该表中查询ID。
如此,在代码中可以直接使用R.id.btnSelectGif来查找对应的控件了。
如何使用string, color对象:
在布局XML中使用使用string, color对象和android一样:采用@string/str-name, @color/color-name来分别引用在string,color中定义的对应的字符串或者颜色值。
这里重点讲一下在代码中使用这两个对象:
//演示R.color.xxx,R.string.xxx在代码中的使用。
COLORREF crRed = GETCOLOR(R.color.red);
SStringW strVer = GETSTRING(R.string.ver);
上面是demo:winmain中一个使用示例。
R.color.red, R.string.ver是自动生成的两个整数,GETCOLOR, GETSTRING这两个宏会自动从资源中的字符串表及颜色表中获取对应的ID指定的值。
启程软件 2016年2月22日