【转】symbian 各种资源的定义

原文：http://blog.csdn.net/wistaria2002/archive/2008/07/23/2699133.aspx

 

一、最基本的定义格式
/* Copyright (c) 2002, Nokia. All rights reserved */

NAME HELL　　//资源的ＩＤ。在一个项目内保证无重复名称

#include <eikon.rh>        //必须的一些内部结构和常量的定义
#include <eikon.rsg>       //必须的一些内部结构和常量的定义
#include <avkon.rh>        //必须的一些内部结构和常量的定义
#include <avkon.rsg>       //必须的一些内部结构和常量的定义
#include "HelloWorld.hrh"  //自定义的一些内部结构和常量的定义

// ---------------------------------------------------------

//  以下两个不许在任何程序中做任何修改
//    This resource should be empty.

RESOURCE RSS_SIGNATURE { }

//    Default Document Name

RESOURCE TBUF r_default_document_name { buf=""; }

// ---------------------------------------------------------

//标识菜单和快捷键的资源ＩＤ

RESOURCE EIK_APP_INFO
{
    menubar = r_helloworld_menubar;
    cba = R_AVKON_SOFTKEYS_OPTIONS_EXIT;
}

// ---------------------------------------------------------

// 定义菜单

RESOURCE MENU_BAR r_helloworld_menubar
{
    titles =
        {
        MENU_TITLE {menu_pane = r_helloworld_menu;}
        };
}

// ---------------------------------------------------------

// 定义子菜单

RESOURCE MENU_PANE r_helloworld_menu
{
    items =
        {
        MENU_ITEM {command = EHelloWorldCommand1;  txt = "Hello";},

        //如果有子菜单，那么加入cascade = r_aknexlist_item_menu;这里

        // RESOURCE MENU_PANE r_aknexlist_item_menu

        MENU_ITEM {command = EAknSoftkeyExit;   txt = "Exit";}
        };
}



/* 定义了字符串资源。虽然这里是小写。但是在程序中引用时必须全部大写。这个和symbian的编译器相关。他把rss的资源串编译 到<SDK_installation_directory>/include路径下，成为rsg文件。而CPP实际上#include的是 这个rsg文件。*/

RESOURCE TBUF32 r_hewb_command1_text { buf=qtn_hewb_command1_text; }

RESOURCE TBUF32 r_hewb_caption_string { buf=qtn_hewb_caption_string; }



// End of File



                    

二、关于对话框的定义：
1、  定义一个对话框资源

//构造方式：

    CMmssSendDialog* iSendDialog = new ( ELeave ) CMmssSendDialog;

    iSendDialog->SetMopParent( this );

    iSendDialog->ExecuteLD( R_MMSSEND_DIALOG );

//-------------------------------------------------------------------------------------------



RESOURCE DIALOG r_mmssend_dialog

    {

        flags =   EEikDialogFlagNoDrag |    // 无法拖曳

                  EEikDialogFlagNoTitleBar |  //无标题栏

                  EEikDialogFlagFillAppClientRect | //将应用程序客户区填满

                  EEikDialogFlagCbaButtons |  //使用CBA按钮

EEikDialogFlagModeless;   //不接受按钮事件

//以上可以参见SDK  ：Developer Library ? API Reference ? C++ API reference ? UIKLAFGT

    buttons = R_AVKON_SOFTKEYS_OPTIONS_EXIT;

    form = r_mmssend_form;

    }



// ---------------------------------------------------------

//默认的单行显示模式

  
// ---------------------------------------------------------

//可以设置为double行显示


RESOURCE FORM r_mmssend_form

    {

    flags = EEikFormEditModeOnly |

EEikFormUseDoubleSpacedFormat;

//Specify a style of form optionally. The default setting is single line display.
//1、EEikFormUseDoubleSpacedFormat : Double line display.
//2、EEikFormHideEmptyFields : To make empty data fields Invisible.
//3、EEikFormShowBitmaps : To display a bitmap on a label.
//4、EEikFormEditModeOnly : To display the form in edit mode only.

    items =

        {

        DLG_LINE

            {

type = EEikCtEdwin;    //是一个编辑文本框 Editor window

//实际上这个是枚举类型，可参看SDK：

//Developer Library ? API Reference ? C++ API reference ? UIKLAFGT ? UIKLAFGT Resource Constants ? TEikStockControls

    prompt = qtn_mmssend_recipient_prompt;// 这个控件的label显示的字符串

            id = EMmsRecipientEditor;

            control = EDWIN

                {

                flags = EEikEdwinNoHorizScrolling | EEikEdwinResizable;

                width = qtn_mmssend_recipient_width;

                maxlength = qtn_mmssend_recipient_maxlenght;

                default_input_mode = EAknEditorNumericInputMode;//数字输入模式

                };

},


           DLG_LINE

            {

            type = EEikCtEdwin;

               prompt = qtn_mmssend_subject_prompt;

            id = EMmsSubjectEditor;

            control = EDWIN

                {

                flags = EEikEdwinNoHorizScrolling | EEikEdwinResizable;

                width = qtn_mmssend_subject_width;

                maxlength = qtn_mmssend_subject_maxlenght;

                default_input_mode = EAknEditorTextInputMode;//文本输入模式

                };

            }



           };

}

三、定义AVKON_VIEW：
该类相当于新的view函数。

构造函数的承载

BaseConstructL( R_AKNEXLIST_VIEW_COLUMNVIEW );

//--------------------------资源-----------------------------------------------------

RESOURCE AVKON_VIEW r_aknexlist_view_columnview

    {

    menubar = r_aknexlist_menubar_main;

    hotkeys = r_aknexlist_hotkeys;

}

四、定义LISTBOX:
构造LISTBOX：

1)

resourceId = R_AKNEXLIST_MENULIST_SINGLE_NUMBER_HEADING;

//可以用祖先     CEikFormattedCellListBox* iListBox;在类中先申明该对象。调用的使用可以根据需要创建需要的派生类。
listBox = new(ELeave)CAknSingleStyleListBox();

listBox->SetContainerWindowL( parent);
TResourceReader reader;
CEikonEnv::Static()->CreateResourceReaderLC(reader, aResourceId);
listBox->SetObserver(observer);
listBox->ConstructFromResourceL( reader );
CleanupStack::PopAndDestroy(); // resource stuffs.





2) CEikColumnListBox* iColListBox;
CEikFormattedCellListBox* iForListBox;

iColListBox = new (ELeave) CAknSingleStyleListBox();
iForListBox = new (ELeave) CAknDoubleGraphicStyleListBox();

iColListBox->SetContainerWindowL( *this );
iForListBox->SetContainerWindowL( *this );

//从资源文件中生成LISTBOX
TResourceReader reader;
CEikonEnv::Static()->CreateResourceReaderLC( reader, R_TEST_SINGLE);
iColListBox->ConstructFromResourceL( reader );

CEikonEnv::Static()->CreateResourceReaderLC( reader, R_TEST_DOUBLE);
iForListBox->ConstructFromResourceL( reader );

//设置SCROLLBAR
iColListBox->CreateScrollBarFrameL( ETrue );
iColListBox->ScrollBarFrame()->SetScrollBarVisibilityL(
CEikScrollBarFrame::EOff, CEikScrollBarFrame::EAuto );

iForListBox->CreateScrollBarFrameL( ETrue );
iForListBox->ScrollBarFrame()->SetScrollBarVisibilityL(
CEikScrollBarFrame::EOff, CEikScrollBarFrame::EAuto );

//适合窗口大小
iColListBox->SetRect(Rect());
iForListBox->SetRect(Rect());

//激活
iColListBox->ActivateL();
iForListBox->ActivateL();

//--------------------------样式一览参观-----------------------------------------------------------
// CAknDoubleStyleListBox

  
//CAknDoubleNumberStyleListBox();

  
//CAknDoubleLargeStyleListBox()


//CAknDoubleStyleListBox();


//CAknDoubleLargeStyleListBox();

  
//-----------------listbox属性-------------------------------------------------------

RESOURCE LISTBOX r_aknexlist_menulist_single_number_heading

    {

    array_id = r_aknexlist_item_single_number_heading;

    flags = EAknListBoxMenuList;

    }

RESOURCE ARRAY r_aknexlist_item_single_number_heading

    {

    items =

        {

        LBUF

            {

            txt = “item1”;

            },

        LBUF

            {

            txt = ”item2”;

            },

        LBUF

            {

            txt = ”item3”;

            },

        LBUF

            {

            txt = ”item4”;

            },

        LBUF

            {

            txt = ”item5”;

            },

        LBUF

            {

            txt = ”item6”;

            }

        LBUF

            {

            txt = ”item7”;

            }

        };

    }







五、定义Tedit:
CEikLabel*  iLabel2;//定义标签

        CEikEdwin*  iEdwin;//定义edit.

CEikGlobalTextEditor*   iGTextEd;//定义基本上同edit


--------------------资源------------------------------------------

RESOURCE GTXTED r_aknexeditor_view1_gtexted

    {

    flags = EAknEditorFlagDefault;

    width = qnn_aknexeditor_view1_gtexted_width;

    height = qnn_aknexeditor_view1_gtexted_height;

    numlines = qnn_aknexeditor_view1_gtexted_numlines;

    textlimit= qnn_aknexeditor_view1_gtexted_textlimit;

    fontcontrolflags = EGulFontControlAll;

    fontnameflags = EGulNoSymbolFonts;

    }

----------------------------------------------------------------------



iCoeEnv->ReadResource( text, R_AKNEXEDITOR_VIEW1_LABEL1);

------------------------------资源-------------------------------------------------------

RESOURCE TBUF32 r_aknexeditor_view1_label1

    {

    buf = qtn_aknexeditor_label_edwin;

    }

--------------------------------------------------------------------------------------------------

    iLabel2 = new ( ELeave ) CEikLabel;

    iLabel2->SetContainerWindowL( *this ); //设置附着的容器

    iLabel2->SetTextL( text );

    iLabel2->SetExtent( GTEXTED_LABEL_POS, iLabel1->MinimumSize() );



    TResourceReader reader;

    iCoeEnv->CreateResourceReaderLC( reader, R_AKNEXEDITOR_VIEW1_EDWIN );

//将资源数据读入

    iEdwin = new ( ELeave ) CEikEdwin;

    iEdwin->SetContainerWindowL( *this );//设置附着的容器

    iEdwin->ConstructFromResourceL( reader );

    //将资源和iEdwin关联。

iEdwin ->SetExtent( position, iEdwin ->MinimumSize() );

// 其中TPoint position;设置主要的控件位置

// 以下是设置情况 Edwins

iEdwins->SetAknEditorCase( EAknEditorUpperCase );

//->SetAknEditorCase( EAknEditorLowerCase );

//->SetAknEditorCase( EAknEditorTextCase );

--------------------------资源----------------------------------------------------------------------

RESOURCE EDWIN r_aknexeditor_view1_edwin

    {

    flags = EAknEditorFlagDefault;

    width = qnn_aknexeditor_view1_edwin_width;

    lines= qnn_aknexeditor_view1_edwin_height;

    maxlength = qnn_aknexeditor_view1_edwin_maxlength;

    }

------------------------------------------------------------------------------------------------------------

    CleanupStack::PopAndDestroy();  // Resource reader

    iEdwin->SetExtent( EDWIN_POS, iEdwin->MinimumSize() );

iEdwin->SetFocus( ETrue );//设置控件的焦点。





六、字符串数组类：
CDesCArrayFlat* items =

iCoeEnv->ReadDesCArrayResourceL( R_AKNEXEDITOR_VIEW5_LABELS );

CleanupStack::PushL( items );

---------------------------资源定义---------------------------------------------------------



RESOURCE ARRAY r_aknexeditor_view5_labels

    {

    items =

        {

        LBUF { txt = qtn_aknexeditor_view5_label1; },

        LBUF { txt = qtn_aknexeditor_view5_label2; },

        LBUF { txt = qtn_aknexeditor_view5_label3; },

        LBUF { txt = qtn_aknexeditor_view5_label4; },

        LBUF { txt = qtn_aknexeditor_view5_label5; },

        LBUF { txt = qtn_aknexeditor_view5_label6; }

        };

    }

七、如何控制多个面版（view）
1、  CAknNavigationControlContainer* iNaviPane;

CAknTabGroup*                   iTabGroup;

CAknNavigationDecorator*        iDecoratedTabGroup;

CAknTitlePane*                  iTitlePane;

CAknExEditorScenarioManager*    iScenarioManager;

TUid                            iCurrentViewId;

2、CEikStatusPane *sp = StatusPane();

iTitlePane =

  static_cast<CAknTitlePane*>( sp->ControlL( TUid::Uid( EEikStatusPaneUidTitle ) ) );

    iNaviPane = ( CAknNavigationControlContainer* ) sp->ControlL(

        TUid::Uid( EEikStatusPaneUidNavi ) );

    iDecoratedTabGroup = iNaviPane->ResourceDecorator();

    if ( iDecoratedTabGroup )

        {

        iTabGroup = ( CAknTabGroup* ) iDecoratedTabGroup->DecoratedControl();

        }

    // 屏幕管理器

iScenarioManager = new ( ELeave ) CAknExEditorScenarioManager;

3、各种VIEW后，加入调用

// Create and add views.

    CAknExEditorView1* view1 = new ( ELeave ) CAknExEditorView1;

    CleanupStack::PushL( view1 );

    view1->ConstructL();

    CleanupStack::Pop();    // view1

    AddViewL( view1 );        //加入调用

    CAknExEditorView4* view4 = new ( ELeave ) CAknExEditorView4;

    CleanupStack::PushL( view4 );

    view4->ConstructL();

    CleanupStack::Pop();    // view4

AddViewL( view4 );        //加入调用

4、激活一个VIEW：

ActivateViewL( view1->Id() );

//-----------------------实现--------------------------

void CAknExEditorAppUi::ActivateViewL( TUid aViewId )

    {

    ActivateLocalViewL( aViewId );

    iCurrentViewId = aViewId;



    TBuf<KTitleBufLength> newTitle;

    iScenarioManager->GetTitle( aViewId, &newTitle );

    iTitlePane->SetTextL( newTitle );

    }

5、实现前翻、后翻

void CAknExEditorAppUi::ActivateNextViewL()

    {

    TUid viewId = iScenarioManager->NextViewTo( iCurrentViewId );

    if ( viewId == TUid::Uid( KScenarioNotFound ) )

        {

        viewId = iScenarioManager->FirstViewId();

        }

    ActivateViewL( viewId );

    }



// ----------------------------------------------------

// CAknExEditorAppUi::ActivatePrevViewL()

// Activates previous view.

// ( other items were commented in a header ).

// ----------------------------------------------------

//

void CAknExEditorAppUi::ActivatePrevViewL()

    {

    TUid viewId = iScenarioManager->PrevViewTo( iCurrentViewId );

    if ( viewId == TUid::Uid( KScenarioNotFound ) )

        {

        viewId = iScenarioManager->LastViewId();

        }

    ActivateViewL( viewId );

    }



八、MCoeControlObserver接口：
这个接口可以直接派生出VIEW的容器类

class CAknExEditorContainer : public CCoeControl, McoeControlObserver

这种容器类可以在view的容器上嵌入相关的edit、label等组件。而不是用

GC来直接操作这些界面元素。



在view类中如何调用：



    private:

        void DoActivateL( const TVwsViewId& /*aPrevViewId*/,

                          TUid /*aCustomMessageId*/,

                          const TDesC8& /*aCustomMessage*/ );//创建容器类

        void DoDeactivate();//删除容器类

        CAknExEditorContainer1* iContainer;//-------------------implentment---------------------

void CAknExEditorView1::DoActivateL( const TVwsViewId& /*aPrevViewId*/,

                                     TUid /*aCustomMessageId*/,

                                     const TDesC8& /*aCustomMessage*/ )

    {

    iContainer = new ( ELeave ) CAknExEditorContainer1;

    iContainer->SetMopParent( this );

    iContainer->ConstructL( ClientRect() );

    AppUi()->AddToStackL( *this, iContainer );

    }

    void CAknExEditorView1::DoDeactivate()
    {

        if ( iContainer )
        {
          AppUi()->RemoveFromStack( iContainer );

        }

    delete iContainer;

    iContainer = NULL;

    }