Symbian资源文件浅析
来源:互联网 发布:主成分分析 软件 编辑:程序博客网 时间:2024/04/30 07:47
一、何为资源文件:在symbian应用程序中,资源文件指的是后缀名为.rss的文件,每个应用程序至少要有一个与之关联的资源文件。资源编译器rcomp编译资源文件后,生成一个.rsc二进制文件和一个相伴的头文件(.rsg)。这样在应用程序框架启动应用程序时,会打开这个二进制文件,借助在.rsg文件中创建的资源标志符,根据需要把各个资源加载到C++代码中。
二、资源文件的作用:在资源文件中指定用户界面的布局,如常用组件菜单、对话框、列表等在界面上的排列样式,另外还可以在其中指定界面上用户可见的文本信息。当然,这些可见文本并不一定通过字符串在.rss资源文件中定义,我们一般在.loc本地文件中定义,而只需在.rss资源文件中将.loc本地文件引入(include)即可。
三、与资源文件有关的系统头文件及其他文件:在资源文件中,往往会引入许多头文件,这包括系统头文件和用户自定义的头文件。其中系统头文件的目录为:“SDK目录/ Epoc32/include/”,以#inlude < >形式引入;用户头文件的目录为“工程目录/inc/”,以#include ” ”形式引入。比如HelloWorld.rss中的引入文件如下:#include <eikon.rh>#include "HelloWorld.hrh"#include "HelloWorld.loc"#include <avkon.rsg>#include <avkon.rh>#include <avkon.mbg>可以看出,资源文件中引入的文件的扩展名一般不是.h。那么这些头文件在资源文件起到什么作用呢?经查看它们的源文件得出:eikon.rh、avkon.rh还有uikon.rh:这些系统头文件主要用于定义一些资源的结构,即在其中定义了许多的STRUCT,在这些STRUCT中,有的项在给出声明的同时进行了默认初始化值,而有的仅仅是给出了声明。eikon.rh主要是一些通用的STRUCT,如STRUCT POINT TIME CLOCK等;uikon.rh主要是一些基本的组件STRUCT定义;avkon.rh主要是S60特有的组件STRUCT定义。扩展名比较特殊的系统头文件:avkon.rsg:这个文件里全是define语句,比如:#define R_AVKON_MENUPANE_EMPTY 0x8cc0002#define R_AVKON_MENUPANE_EXIT 0x8cc0003#define R_AVKON_MENUPANE_APP_DEFAULT 0x8cc0004#define R_AVKON_MENUPANE_VIEW_DEFAULT 0x8cc0005#define R_AVKON_MENUPANE_FEP_DEFAULT 0x8cc0006#define R_AVKON_MENUPANE_EDITTEXT_DEFAULT 0x8cc0007#define R_AVKON_MENUPANE_LANGUAGE_DEFAULT 0x8cc0008像是一些资源标志符的定义,用16进制数对avkon里面的所有资源进行定义。跟编译.rss资源文件时生成的.rsg文件一个扩展名。avkon.mbg:这个文件只定义了一个枚举变量TmbmAvkon,如下:enum TMbmAvkon { EMbmAvkonQgn_graf_tab_21, EMbmAvkonQgn_graf_tab_21_mask, EMbmAvkonQgn_graf_tab_22, EMbmAvkonQgn_graf_tab_22_mask, EMbmAvkonQgn_graf_tab_31, EMbmAvkonQgn_graf_tab_31_mask, 。。。}HelloWorld.hrh:这是一类具有代表性的资源头文件,有用户自定义的,也有系统的。这类文件可以包含enum定义,意味着可以在资源文件.rss和C++源文件.cpp之间共享一个只包含enum定义的头文件,这是定义在两种类型的文件间共享的值的常用方法。内容如下:#ifndef HELLOWORLD_HRH#define HELLOWORLD_HRHenum ThelloWorldCommandIds //为菜单命令定义枚举值 { EHelloWorldCmdAppTest = 1 };#endif // HELLOWORLD_HRHHelloWorld.loc:.loc 文件用于放置本地化的语言文字,比如你可以分别为中文和英文创建一个 .loc 文件,一个用于存放英文文本,一个用于存放中文文本。内容如下:// LOCALISATION STRINGS#define qtn_appl_test "YanHaitao"// menu exit#define qtn_appl_exit "Exit"// example caption strings for app#define qtn_app_caption_string "YanHaitao"#define qtn_app_short_caption_string "YanHaitao"// Localized string for r_message_text#define R_MESSAGE_TEXT_STRING "Hello World!"这其中的qtn_appl_test等变量,都能在.rss文件中找到,这个文件是对这些变量的赋值。本地文件如果要使用中文,那么使用CHARACTER_SET UTF8指定资源字符集,另外需要注意的是,rss文件和loc等相关文件也需要保存为UTF-8格式,具体的使用Windows的记事本,EditPlus都可以。
四、资源文件的结构:介绍完与资源文件相关的文件后,我们来看看一个资源文件的具体结构:它由两部分构成,分别称为头部和主体。1、头部:含有前面我们所说的包含语句和一些资源文件标准信息。(1)名字:用NAME语句定义,该语句必须是资源文件中第一个有意义的行,即除去注释和空白语句,也就是说,这条语句要位于include包含语句之前,后面没有分号。该语句指定一个由1到4个字符组成的名字,并建议使用大写字符。如果应用程序使用了多个资源文件的话,那么可以通过它进行区分。如:NAME HELL(2)include包含语句:允许使用其他地方定义的符号和结构。(3)签名:它的内容实际上被忽略,但必须有这条语句,否则加载资源时便报错。一般将实际内容置为空,如:RESOURCE RSS_SIGNATURE { } ,后面没有分号。(4)文档名缓冲:指定应用程序默认文档名的TBUF资源。大部分程序不使用文档,但仍然必须包含此资源,否则加载资源失败。不需指定文件的扩展名,因为S60本地文档不使用扩展名。如:RESOURCE TBUF { buffer=”HelloWorld”;}在这里的文件名将作为参数传递给CAknDocument类的OpenFileL(TBool aDoOpen, const TDesC& aFilename, RFs& aFs)方法。这允许一个应用程序在运行时打开一个默认的文档。如果这里的值为空那么程序默认文档名和应用程序名一致。(5)应用程序信息资源:这个资源比较重要。EIK_APP_INFO资源为应用程序指定各种标准控件。如状态面板等,通常会创建一个为状态面板指定新内容的资源,然后使用EIK_APP_INFO资源的status_pane字段引用它。如:RESOURCE EIK_APP_INFO { hotkeys = r_HelloWorld_hotkeys; menubar = r_HelloWorld_menubar; cba = R_AVKON_SOFTKEYS_OPTIONS_BACK; }注意:头部中定义的各种资源都没有资源名。2、主体:定义了应用程序中将要使用的资源。它的定义格式如下:RESOURCE STRUCTNAME resource-name{ resource-initializer-list}在这里STRUCTNAME应替换为具体的资源结构类型,而这些资源结构类型就在我们前面提到的eikon.rh、uikon.rh、avkon.rh中进行定义的。资源名resource-name必须小写,通常以r_开头,而在C++文件中使用他们时必须大写,这和资源编译器工作方式有关。例如:RESOURCE HOTKEYS r_HelloWorld_hotkeys { control = { HOTKEY { command = EAknCmdExit; key='e'; } };}下面具体研究一下,具体资源的定义方法和过程。初始化字段有三种不同方式:简单初始化器、数组初始化器、结构初始化器。如下:RESOURCE STRUCT r_my_example_struct{ simple=EeikCtLabel; //简单初始化器,分配单个值或字符串 array={1,2,3}; //数组初始化器,大括号,元素用逗号隔开 structmember=OTHERSTRUCT //结构初始化器,编译器不进行类型检查,要小心{ simple1=”hello”; simple2=”goodbye”;}}针对具体资源定义的说明:(1)字符串资源:可以使用TBUF资源将字符串包含在资源文件中。通常,会在一个.loc文件中或是在指定语言的.lxx文件中定义字符串文字,而不是在.rss文件中定义它们,只需在.rss文件中将.loc文件包含进来即可。.lxx文件中的xx应该替换为e32std.h中的Tlanguage枚举定义的两位数字区域设置码,之后按照.mmp项目文件中设置的当前生成区域设置把.lxx文件包含到.loc文件中。看一个定义了.lxx文件的.loc文件实例:#ifdef LANGUAGE_01#include “MyApp.101”#endif#ifdef LANGUAGE_02#include “MyApp.l02”#endif最后,.101和.102文件以各自的语言定义字符串,比如:#define STR_HELL0 “Hello World”为了确保编译资源时将使用正确的字符串,应该在.mmp文件中包含一行或多行LANG语句,导致生成两个二进制资源文件:.r01和.r02。LANG 01LANG 02(2)标点:介绍如何使用标点符号a、所有赋值语句之后都应该有分号b、列表中的元素以逗号分隔c、资源定义后以及列表中最后一个元素之后不应有分号举例:RESOURCE AVKON_VIEW r_myapp_view{menubar=r_myapp_menubar;//赋值语句后有分号cba=r_myapp_cba;//赋值,需要分号} //资源定义结尾,无需分号…RESOURCE TAB_GROUP r_myapp_tabgroup{ tab_width=EaknTabWidthWithTwoTabs; active=0; tabs={ TAB //列表中的第一个TAB STRUCT{ id=EnavigationPaneTab1; txt=TAB1_TEXT;}, //列表元素之间用逗号分隔TAB{ id=EnavigationPaneTab2; txt=TAB2_TEXT;} //列表结尾无需分号 }; //将列表赋值给tabs,需要分号。}(3)创建资源结构:RESOURCE语句用于创建特定资源的实例,而STRUCT语句则用于定义资源类型,创建的所有STRUCT定义都应改保存在一个扩展名为.rh的文件中。注意:STRUCT的名字必须全部为大写,不能含有空格,且必须以字母字符开始。常用STRUCT字段类型:BYTE、WORD、LONG、DOUBLE、TEXT、LTEXT、BUF、BUF8、BUF<n>、LINK、LLINK、SRLINK、STRUCT等除简单字段外,还可以把字段定义为一个由相同类型的值组成的数组,在字段名后添加一对方括号即可。如:STRUCT MENU_PANE{ STRUCT items[ ]; LLINK extension=0;}
源自:http://www.sf.org.cn/Article/symbiandev/200607/18832.html
- Symbian资源文件浅析
- Symbian资源文件浅析
- Symbian资源文件浅析
- Symbian资源文件浅析
- Symbian资源文件浅析
- symbian资源文件浅析
- 【转】Symbian资源文件浅析
- Symbian资源文件浅析(来自:风生水起)
- Symbian 资源文件解析
- Symbian 资源文件解析
- Symbian 资源文件解析
- Symbian 资源文件解析
- Symbian 资源文件解析
- symbian 资源文件含义
- Symbian 资源文件解析
- Symbian 资源文件解析
- Symbian 资源文件解析 .
- Symbian OS 资源文件(.rss)(zz)
- myeclipse 6.0 快捷键 ALT+/的使用
- 使用ASP.Net Forms模式实现WebService身份验证
- SQL--JOIN之完全用法
- J2se小项目:坦克大战
- 新工作080624
- Symbian资源文件浅析
- ~~~经典爆笑口误~~~
- VC 获取当前时间程序
- AT指令发送短信
- 搜索引擎爬虫一览表
- PetShop4.0架构分析
- SQL数据库的访问类
- Windows核心编程-读书笔记1-3
- 用于绑定asp.net控件的类