诺基亚symbian 手册汇编4

资源文件

指定了应用程序的相关信息,包含要显示的控件定义(如菜单,对话框等),是所有应用程序所必须的。
资源文件的后缀名为<application name>.rss。最多可以包含4095个资源。
一个应用程序可以包含多个资源文件,并在运行时动态加载其他资源文件。
Uikon预先定义了许多在资源文件中可以使用的结构体。
资源文件需要编译成二进制文件,在C++代码中需要include编译产生的.rsg文件。
具体的文件及解释如下:

// 4 letter ID 该字段必须每个应用程序唯一

NAME S60R   

//  INCLUDES  包含已经定义的资源结构

#include <eikon.rh>

#include <avkon.rh>

#include <avkon.rsg>

#include <appinfo.rh>

//hrh用于包含枚举常量,如菜单项;rls定义了在UI中使用的字符串

#include "S60ResourceLab.hrh"

#include "S60ResourceLab.rls"

//允许应用程序指定版本号,可选

RESOURCE RSS_SIGNATURE

    {

    }

//为该应用程序的默认文件指定一个名字

RESOURCE TBUF r_default_document_name

    {

    buf="HEWB";

    }

//指定了所要显示的菜单和soft keys

RESOURCE EIK_APP_INFO

    {

    menubar=r_s60resourcelab_menubar;

    cba=R_AVKON_SOFTKEYS_OPTIONS_BACK;

    }

菜单相关:

//定义了需要显示的menu pane,txt字段为空(S80中才有位置显示菜单的title,S60没有)

RESOURCE MENU_BAR r_s60resourcelab_menubar

    {

    titles=

        {

        MENU_TITLE { menu_pane=r_s60resourcelab_menu; txt=""; }

        };

    }

//menu pane定义了一系列menu items,command就是HandleCommandL中接收的命令参数,txt显示给用户。

RESOURCE MENU_PANE r_s60resourcelab_menu

    {

    items=

        {

        MENU_ITEM { command=EAknCmdExit; txt="Exit"; },

        MENU_ITEM { command=ES60ResourceLabCmdAppTest; txt="Test"; }

        };

    }

字符串相关:字符串的内容真正定义的位置是在本地化文件中,见后。

RESOURCE TBUF r_s60resourcelab_text_goodbye

    {

    buf = qtn_s60resourcelab_text_goodbye;

    }

RESOURCE TBUF r_s60resourcelab_text_everyone

    {

    buf = qtn_s60resourcelab_text_everyone;

    }

Localisation Files    每种显示给用于的语言都有一个本地化文件,在该文件中包含所有需要翻译的语言。

可以在rss文件中被条件包含,如下所示:

#ifdef LANGUAGE_01

    #include "HelloWorld01.rls"

#elif defined LANGUAGE_02

    #include "HelloWorld02.rls"

#endif

    示例:keyword symbolic_identifier the_string

rls_string qtn_caption_string "S60 Resource Lab"

rls_string qtn_s60resourcelab_text_goodbye "Goodbye"

Resource Compilation    资源编译器将rss文件编译为rsc文件,中间产生一个rsg的头文件。

    C++代码中使用resource需要包含rsg头文件,使用方法如下:

HBufC* textResource = StringLoader::LoadLC( R_COMMAND1_TEXT );

iLabel->SetTextL(*textResource);

CleanupStack::PopAndDestroy( textResource );

读后感Symbian的资源对于初学者来说也是一个很棘手的问题。

往往添加一个menu item需要同时改很多地方,稍不小心就N多错误,让人摸不着头脑。

但是熟悉之后,一切都显得那么自然,也许这就叫熟能生巧吧,呵呵。

 

peter (2007-11-04 16:07:01)

Basic Application Structure    一般应用程序都分为UI和Engine两部分。


UI负责显示和接受用户命令
Engine负责处理数据,可以被其他应用程序重用
Basic Application Classes    下图展示了一个最基本的应用程序类图,其中每部分的作用如下:

诺基亚symbian 手册汇编4 - jianhai1229 - 水木博客

Application:返回UID3,创建Document类
Document:主要创建Application UI,也可以从文件中读写状态数据
App UI:主要的用户界面,本身不可见,但是拥有可见控件,主要处理菜单命令和按键事件
View/Container: 包含用户可见的控件,一个应用程序中可能有多个view或container
Model:根据应用程序情况的不同,可能被Document,AppUI或者View所拥有
Class Derivations    下图展示了一个CMyApp应用程序的类继承关系,总共有四层:

诺基亚symbian 手册汇编4 - jianhai1229 - 水木博客最上层:CMyApp类,用户应用程序相关类
Avkon层:CAkn类与S60应用程序框架相关的类
Uikon层:CEik类勾勒出应用程序框架,在所有的UI设计中(如S60,UIQ,FOMA等)都存在
AppArc层:CApa类定义了最基本的应用程序接口
CONE层:CCoe类定义了最基本的可见控件(CCoeControl),底层的异步事件处理(其他两个)。
Startup Sequence    下图解释了应用程序框架类的创建顺序,当应用程序开始时,首先调用的是E32Main()函数,由它调用应用程序框架来产生应用程序对象。具体过程如图所示,可以对照一个HelloWorld GUI程序看看:

诺基亚symbian 手册汇编4 - jianhai1229 - 水木博客

 需要注意的地方:最后一步,只有当CCoeControl::ActivateL()被调用并且控制返回到系统的Active Scheduler(应用程序事件循环),Container的Draw()才会被调用,即控件才会显示出来。

Appcliation Entry Point    Symbian中的每个应用程序都运行在其自己的进程中,必须实现以下两个全局函数(通常向导已经帮你生成了):


E32Main():应用程序主入口,调用系统框架函数EikStart::RunApplication()来初始化和运行应用程序
NewApplication():应用程序进程创建一个应用程序实例,该实例必须继承自CApaApplication
以上信息专门针对Symbian 9.x,在以前的版本中,应用程序是作为一个多态的Dll实现的。


下面详细介绍一个应用程序框架中各个主要的类

Application Class     当应用程序启动后第一个产生的类,继承自CAknApplication,它定义了一个应用程序最基本的行为。

class CMyAppApplication : public CAknApplication

    {

    public: // Functions from base classes

        TUid AppDllUid() const;

    protected: // Functions from base classes

        CApaDocument* CreateDocumentL();

    };

该类主要有两个功能:


首先返回每个应用程序唯一的UID3


然后产生一个具体的document对象
Document


    Document类一般用来将应用程序的数据保存到文件中,保持程序持久性。但是默认情况下Symbian不使用文件。

class CMyAppDocument : public CAknDocument

    {

    public: // Constructors and destructor

        static CMyAppDocument* NewL( CEikApplication& aApp );

        static CMyAppDocument* NewLC( CEikApplication& aApp );

        virtual ~CMyAppDocument();

    public: // Functions from base classes

        CEikAppUi* CreateAppUiL();

    private: // Constructors

        void ConstructL();

        CMyAppDocument( CEikApplication& aApp );

    };

不使用文件,该类主要有两个功能:


二阶段构造,创建一个Document对象:外部接口为NewL,默认构造函数和二阶段构造函数都为private。
创建一个AppUi
App UI    作为应用程序用户接口,它创建并拥有用于显示用户数据的控件,但是本身不负责显示,主要用来处理菜单命令和按键事件。通过实现以下虚函数,可以处理相应事件:


HandleKeyEventL():按键事件

HandleForgroundEventL():应用程序被切换到前台

HandleSwitchOnEventL():手机开机事件

HandleSystemEventL():系统事件

HandleWsEvent():窗口服务器事件

HandleApplicationSpecificEventL():应用程序相关的事件

HandleCommandL():处理定义在文件中的命令

class CMyAppAppUi : public CAknAppUi

    {

    public: // Constructors and destructor

        void ConstructL();

        CMyAppAppUi();

        virtual ~CMyAppAppUi();

    private:  // Functions from base classes

        void DynInitMenuPaneL(TInt aResourceId, CEikMenuPane* aMenuPane);

        void TKeyResponse HandleKeyEventL(const TKeyEvent& aKeyEvent, TEventCode& a Type); 

        void HandleCommandL( TInt aCommand );

        void HandleStatusPaneSizeChange();

    private: // Data

        CMyAppAppView* iAppView;  

    };

    从定义中可以看到这里并没有二阶段构造(NewL,NewLC) ,因为第一阶段构造和第二阶段构造都是应用程序框架调用的:CMyAppDocument::CreateAppUiL(),CEikAppUi::ConstructL()。

 

CMyAppAppUi::DynInitMenuPaneL() 显示菜单之前由应用程序框架调用,以便动态控制菜单显示的内容。


CMyAppAppUi::HandleKeyEventL() 当有按键事件发生并没有被其他控件处理时,系统调用此函数。

 

CMyAppAppUi::HandleCommandL() 当用户按下菜单命令时调用,如何定义一个菜单命令在下一讲中详述。


    AppUi生成Container:根据S60的惯例,所有控件都成为container,至少有一个container在AppUi的第二阶段构造中生成。其中有以下几个主要函数:

 

SetMopParent() 使得container可以访问AppUi,以便显示滚动条等
AddToStack() 将container添加到App UI的控制堆栈,以便接收按键事件
Container Class    一个container可以包含任意多个控件。


class CMyAppAppView : public CCoeControl

    {

    public: // New methods

        static CMyAppAppView* NewL( const TRect& aRect );

        static CMyAppAppView* NewLC( const TRect& aRect );

        virtual ~CMyAppAppView();

    public:  // Functions from base classes

        void Draw( const TRect& aRect ) const;

        virtual void SizeChanged();

        TInt CountComponentControls() const;

        CCoeControl* ComponentControl(TInt aIndex) const;

    private: // Constructors

        void ConstructL(const TRect& aRect);

        CMyAppAppView();

    private: //data

        CEikLabel* iLabel; 

    };

    主要函数解释:


SizeChanged() 当container被创建或者大小发生变化时调用
CountComponentControls() 返回该container所包含的控件数量
ComponentControl() 返回该container所包含的控件的指针
Draw() 执行一些该container相关的显示操作
    所有container的初始化操作在第二阶段构造函数ConstructL()中完成。


    void CMyAppAppView::ConstructL( const TRect& aRect )

    {

    CreateWindowL();

    iLabel = new (ELeave) CEikLabel;

    iLabel->SetContainerWindowL(*this);

    iLabel->SetTextL( _L("Hello World") );  

    SetRect(aRect);

    ActivateL();

    }

    CreateWindowL() 创建该container的一个窗口,以便这个container和它的控件都能显示出来。

    Lable通过三个步骤创建:首先调用默认构造函数、添加到当前window中、设置要显示的字符串。

    SetRect() 设置container的返回,如果Label超出此范围,会被裁减掉

    ActivateL() 最后container发出已经准备好显示的信号,可以执行Draw操作

读后感初学者可以大体浏览一下,因为这是每个应用程序都具备的

当出现应用程序一开始就死掉或者想对应用程序有更好的控制时,须仔细阅读

当熟练掌握本章内容时,当需要添加一个功能时,可以很快找到需要添加的位置

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值