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();
  }