symbian基本类总结

symbian基本类总结

类总结：
四大天王：CaknApplication，CeikDocument，CAknAppUi，CAknView

void CAknAppUi::DynInitMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane )

在显示menu pane之前调用，主要是用来初始化菜单显示的具体项目。

aResourceId 是资源的具体ID，如R_SMS_MENU。

aMenuPane 通过调用aMenuPane->SetItemDimmed（菜单项目资源ID，EFalse）；来显示或隐藏该菜单选项。注意：Etrue为隐藏。

1、话框类：CEikDialog   （OK/CANCEL）
主要成员函数有：

void PreLayoutDynInitL();//处理在对话框出现之前的初始化动作

TBool OkToExitL( TInt aButtonId );//对OK按的处理

Void HandleControlStateChangL(Tint aControlId);//监听对话框上控件改动，有点类似与Appui类的void CAknAppUi::HandleCommandL(TInt aCommand)。

//构造方式：

    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;//文本输入模式

                };
            }
           };

    }

2、周期类：
1、Cperiodic
==================================================================

CPeriodic* iPeriodicTimer;

iPeriodicTimer = CPeriodic::NewL( CActive::EPriorityStandard );//这条语句一般在ConstructL()中

void CGraphicsAppView::StartTimer()//开始启动时钟

    {

    if ( !iPeriodicTimer->IsActive() )

        {iPeriodicTimer->Start( 1, 1,

            TCallBack( CGraphicsAppView::Period, this ) );//TcallBack是一个方法回调函数，从使用来看，他只能回调类中的静态方法。

        }

    }

TInt CGraphicsAppView::Period( TAny* aPtr )//周期启动函数，注意，这是个静态函数，但static只在头文件中才做了申明。

    {

    ( static_cast<CGraphicsAppView*>( aPtr ) )->DoPeriodTask();

    return ETrue;

    }

void CGraphicsAppView::DoPeriodTask()//周期真正在做的事情

    {

    // Update the screen

    CWindowGc& gc = SystemGc();

    gc.Activate( *DrawableWindow() );//如果要求清屏操作。增加gc.Clear();

    UpdateDisplay();///////////////////这个函数是周期需要实现的东西

    gc.Deactivate();

    }

void CGraphicsAppView::StopTiem()//停止时钟

    {

    if ( iPeriodicTimer->IsActive() )

        {

        iPeriodicTimer->Cancel();

        }

    }

2、Rtimer
        RTimer timer;

        TRequestStatus timerStatus;  // ... its associated request status

   timer.CreateLocal();         // Always created for this thread.

for (TInt i=0; i<10; i++)

        {    // issue and wait for single request

        timer.After(timerStatus,1000000);  // 设定时钟请求为1秒

        User::WaitForRequest(timerStatus); // 等待这个请求

             // display the tick count

        _LIT(KFormat3,"Tick %d\n");

        console->Printf(KFormat3, i);

        }

3、Ttime
  TTime time; // time in microseconds since 0AD nominal Gregorian

   _LIT(KTxt2,"The time now is, ");

   console->Printf(KTxt2);

   time.HomeTime(); //设置时间为当前系统时间

   showTime(time);//显示当前时间

//----------------以下代码是人为给时间加10秒--------------

TTimeIntervalSeconds timeIntervalSeconds(10);

   time += timeIntervalSeconds;

   showTime(time); // print the time the request should complete

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

timer.At(timerStatus,time); //设定时钟请求为10秒

User::WaitForRequest(timerStatus); //等待这个请求

        // say it's over, and set and print the time again

   _LIT(KTxt4,"Your 10 seconds are up\nThe time now is, ");

   console->Printf(KTxt4);

   time.HomeTime(); // set time to now

   showTime(time); // print the time

        // close timer

   timer.Close(); // close timer

              

3、字符串类：
TDesC是所有字符类的祖先


标准C语言
Symbian OS

让一个字符串进入2进制代码
Static char hellorom[]=”hello”
_LIT(khellorom,”hello”)

在栈中获得字符串的指针
Const char* helloptr=hellorom
TPtrC helloptr=khellorom

获得在栈中字符串的指针
Char hellostack[sizeof(hellorom)];

Strcpy(hellostack,hellorom);
TBufC<5> hellostack=khellorom;

获得在堆中字符串的指针
Char* helloheap=

(char *)malloc(sizeof(hellorom));

strcpy(helloheap,hellorom);
HBufC* helloheap=

Khellorom.AllocLC();


a)TPtrC相当于不变的字符串常量.

b)TPtr相当与String类型。Tbuf相当于char[]。前者与后者的唯一区别是，后者需要指定分配的栈空间大小。

C)HBufC* 与char*类似。分配的是堆上的空间。

HBufC* textResource;

//两种字符串附值方法

textResource = StringLoader::LoadLC( R_HEWP_TIME_FORMAT_ERROR );

textResource =iEikonEnv->AllocReadResourceL(R_EXAMPLE_TEXT_HELLO);

TBuf<32> timeAsText;

timeAsText = *textResource;

/* 数据类型转换*/


TBuf  转换为 TPtrC16
    TBuf<32> tText(_L("2004/11/05 05:44:00"));
    TPtrC16 tPtrSecond=tText.Mid(17,2);

TPtrC16 转换为 TBufC16
    TPtrC16 tPtrSecond=tText.Mid(17,2);
    TBufC16<10> bufcs(tPtrSecond);

TBufC16 转换为  TPtr16
    TBufC16<10> bufcs(tPtrSecond);
    TPtr16 f=bufcs.Des();

TPtr16 转换为 TBuf
    TBuf<10> bufSecond;
    bufSecond.Copy(f);

TBuf 转换为 TPtr16
    TBuf<10> bufSecond(_L("abc"));
    TPtr16 f;
    f.Copy(bufSecond);

TBuf 转换为 TInt
    TInt aSecond;
    TLex iLexS(bufSecond);
    iLexS.Val(aSecond);

TInt 转换为 TBuf
    TBuf<32> tbuf;
    TInt i=200;
    tbuf.Num(i);

1.串转换成数字
   TBuf16<20> buf(_L( "123" ) );
    TLex lex( buf );
    TInt iNum;
    lex.Val( iNum );
2.数字转换成串
   TBuf16<20> buf;
   TInt iNum = 20;
   buf.Format( _L( "%d" ) , iNum  );
3.将symbian串转换成char串
    char* p = NULL;
    TBuf8<20> buf( _L( "aaaaa" ) );
    p = (char *)buf.Ptr();

4.UTF-8转换成UNICODE
    CnvUtfConverter::ConvertToUnicodeFromUtf8( iBuf16 , iBuf8 );
5.UNICODE转换成UTF-8
    CnvUtfConverter::ConvertFromUnicodeToUtf8( iBuf8 , iBuf16 );


6.将char串转换成symbian串
    char* cc = "aaaa";
    TPtrC8 a;
    a.Set( (const TUint8*)cc , strlen(cc) );

7、将TPtrc8与TPtrc16之间转化

// Get a iBuf8 from a iBuf16 (data are not modified)
TPtrC8 ptr8(reinterpret_cast<const TUint8*>(iBuf16.Ptr()),(iBuf16.Size()*2));
iBuf8=ptr8;

// Get a iBuf16 from a iBuf8 (data are not modified)
TPtrC16 ptr16(reinterpret_cast<const TUint16*>(iBuf8.Ptr()),(iBuf8.Size()/2));
iBuf16=ptr16;


The second one takes each character and convert it to the other format. The 16-bit to 8-bit conversion may not always succeed in this case:

Code:

// Get a iBuf8 from a iBuf16 (data are modified)
CnvUtfConverter::ConvertFromUnicodeToUtf8(iBuf8,iBuf16);

// Get a iBuf16 from a iBuf8 (data are modified)
CnvUtfConverter::ConvertToUnicodeFromUtf8(iBuf16,iBuf8);


This second method requires to include the utf.h header and to link against charconv.lib.

/*memset   memcpy   strcpy */

memset主要应用是初始化某个内存空间。用来对一段内存空间全部设置为某个字符。
memcpy是用于COPY源空间的数据到目的空间中,用来做内存拷贝可以拿它拷贝任何数据类型的对象。
strcpy只能拷贝字符串了，它遇到'\0'就结束拷贝。



strcpy
原型：extern char *strcpy(char *dest,char *src);
用法：#include <string.h>
功能：把src所指由NULL结束的字符串复制到dest所指的数组中。
说明：src和dest所指内存区域不可以重叠且dest必须有足够的空间来容纳src的字符串。
       返回指向dest的指针。
      
memcpy
原型：extern void *memcpy(void *dest, void *src, unsigned int count);
用法：#include <string.h>
功能：由src所指内存区域复制count个字节到dest所指内存区域。
说明：src和dest所指内存区域不能重叠，函数返回指向dest的指针。

memset
原型：extern void *memset(void *buffer, int c, int count);
用法：#include <string.h>
功能：把buffer所指内存区域的前count个字节设置成字符c。
说明：返回指向buffer的指针。








4、文件类和流操作
Location: s32file.h

文件模拟路径在C:\Symbian\8.0a\epoc32\wins下面。有C、D两个分区。

RFs fs;
User::LeaveIfError(fs.Connect());
RFile file
User::LeaveIfError(file.Open(fs, _L("C:\\file.foo"), EFileWrite));
TBuf8<256> buf;
file.Read(buf, 256);
file.Seek(ESeekStart, 911);
file.Write(_L8("Some thing you wanna write..."));
file.Close();
1)      与文件服务器建立通信：

RFs fsSession;

TInt fsret = fsSession.Connect(); // start a file session

       if (fsret != KErrNone)

              {console->Printf(KTxtConnectFailed,fsret);

              User::Leave(fsret);

              }

  2）确定文件路径存在

fsSession.MkDirAll(KFullNameOfFileStore); // make sure directory exists

      



  3）建立文件存储

TParse    filestorename;// The class uses the full filename structure supported by Symbian

       fsSession.Parse(aName,filestorename);

/*------------------------------------------------------------------------------------------------

TDesC& aName。可以通过以下方式给aNAME赋值：
    _LIT(aName,"C:\\epoc32ex\\data\\SimpleClassToSimpleStream.dat");

----------------------------------------------------------------------------------------------*/

                            // construct file store object - the file to contain the

                            // the store replaces any existing file of the same name.

       CFileStore*     //如果EFileRead为读出流

store = CDirectFileStore::ReplaceLC(fsSession,filestorename.FullName(),EFileWrite);

store->SetTypeL(KDirectFileStoreLayoutUid); // 设定存储种类



4）将外部数据写入流：：（记忆方式：>>指向就是数据流向）//假设：TSimple anXxx;

RStoreWriteStream outstream;

       TStreamId id = outstream.CreateLC(*store);

//----------------------------将标量写入数据流------------------

outstream<< anXxx;

    或者 aStream.WriteInt8L(anXxx);

    实际上这里使用了流的扩展化：（当输出不是普通的元数据时，使用这个扩展化）这是一个虚函数的重载

void TSimple::ExternalizeL(RWriteStream& aStream) const

       {

       aStream << iTheEnum;

       aStream << iBuffer;

       aStream.WriteInt32L(iIntValue);

       aStream.WriteUint32L(iUintValue);

       aStream.WriteReal64L(iRealValue);

       }  

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

     // 以下是将流改动提交到文件服务器。

       outstream.CommitL();

5）将流读到外部数据：

       RStoreReadStream instream;

store->SetRootL(id);//可以将上面的已经存在的流作为流的根。好处是不必再创建流ID。实际上也就节省了内存。

// Commit changes to the store

       store->CommitL();

// Construct and open the input stream object. We want to access the root stream from the store in this example.

       instream.OpenLC(*store,store->Root());

TSimple thesimple;

       instream >> thesimple;//写入类对象数据。

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

void TSimple::InternalizeL(RReadStream& aStream)

       {

       aStream >> iTheEnum;

       aStream >> iBuffer;

      iIntValue  = aStream.ReadInt32L();

       iUintValue = aStream.ReadUint32L();

       iRealValue = aStream.ReadReal64L();

       }  

    //------------------------------输出流到其他数据元或类对象中----------------------------

     anXxx = TXxx(aStream.ReadInt8L());

  

6）关闭文件服务通信

fsSession.Close()

    

5. 活动调度表
由于使用多线程来处理异步请求比较消耗系统资源，所以Symbian 使用了活动对象（Active Object）来解决异步请求的问题。
         活动规划器（active scheduler）用于处理由活动对象提出的异步请求。它检测活动对象提出的异步请求，并安排活动对象的请求完成事件的执行顺序。活动规划器仅用一个事件处理线程来规划各个活动对象提出的事件请求，所以它要比多线程实现异步请求占用更少的资源。

1、   首先应该创建一个活动规划器对象，并把它安装到当前线程

       CActiveScheduler* scheduler = new(ELeave) CActiveScheduler();//创建一个活动规划器
   CleanupStack::PushL(scheduler);
   CActiveScheduler::Install(scheduler);// 安装活动规划器。
   TRAPD(error,doInstanceL());   //具体安排的函数处理。

在具体的安排函数中一定要启动这个规划器

CActiveScheduler::Start();//这句话告诉活动规划器该等待对象的状态的改变

2、 把自己加入活动规划器：一般这是一个类。可以在类的构造函数中申明下面代码。
                      CActiveScheduler::Add(this);

     //该类必须有一个继承来自public CActive, public MmsvSessionObserver

//在构造函数时，也可以宣布优先级别：TclassA::classA()  : CActive(0)    

3、返回改变事实：              

SetActive();  / / CActive类对象提交异步请求。

//这个请求说明对象的改变完成。就会触发CActive::RunL()

      4、这里的CActiveScheduler只管理了一个CActive对象,就是timeCount,可以用类似的方法实现多个CActive,并且都加入CActiveScheduler,CActiveScheduler将会等待所有加入它的CActive的状态的改变,其中有一个的状态改变就会去执行对应的活动对象的处理函数,当状态同时发生的时候,会通过对象的优先级来决定先调用谁的RunL函数.CActiveScheduler也是非抢占式的,当一个RunL函数还没有执行完的时候,如果另一个CActive的状态改变,会等待RunL执行完以后再执行另一个CActive的处理函数.



6、线程：
1、  创建一个等待的线程：

     TInt res=KErrNone;

     // create server - if one of this name does not already exist

     TFindServer findCountServer(KCountServerName);

     TFullName name;

     if (findCountServer.Next(name)!=KErrNone) // we don't exist already

         {

RThread thread;

         RSemaphore semaphore;

         semaphore.CreateLocal(0); //创建一个信号量，等待线程的正常结束

         res=thread.Create(KCountServerName,   // create new server thread

              CCountServServer::ThreadFunction, // 线程启动的主函数

              KDefaultStackSize,

              KDefaultHeapSize,

              KDefaultHeapSize,

              &semaphore // 最后是主函数的需要的参数passed as TAny* argument to thread function

              );

         if (res==KErrNone) // thread created ok - now start it going

              {

              thread.SetPriority(EPriorityNormal);

              thread.Resume(); // start it going

              semaphore.Wait(); // wait until it's initialized

              thread.Close(); // we're no longer interested in the other thread

              }

         else // thread not created ok

              {

              thread.Close(); // therefore we've no further interest in it

              }

         semaphore.Close();

         }