深入理解Symbian控件架构

Symbian中的控件都由CCoeControl派生而来，想定义自身的控件同样也需要继承CCoeControl。

 

这个CCoeControl很有意思，实现(或调用)它的不同方法就会产生不同的名称定义或者说是不同类型，至少在整个应用中开发者对它们的功能定义是如此：

 

A视图

       做为视图也就是说，它在继承CCoeControl之后在进行构造时必须要调有CreateWindowL()创建Window窗口，也就是说这是一个带自身窗体的控件，在此控件上可以在Draw()方法中进行图形绘制动作。

 

B不拥有窗口控件     

        它自身并不拥用窗体，它依靠寄宿(视图)窗口来显示（在进行自身构造时不调用CreateWindowL()）。

         从控件数量级别上分又可发为：

1复合控件(Container) 

2.单控件

 

下面我们从CConeControl提供的方法中来进一步的介绍，并详细的介绍一下里面比较重要的方法，更多时候我们仅能够看到一样code sample.并不了解其中那些方法的作用和使用的必要性。

下面我们介绍一个视图code进行剖析：

       在进行代码查看时，我们不必去理会那些无关方法，每个simple里面都有它的一些为了实现某些功能做的一些特殊效果和方法，下面用蓝色标出的是用户不必关心的。

 

class CIeAppView : public CCoeControl

{

       public:

              static CIeAppView* NewL(const TRect& aRect,const TInt &aInt,CQikAppUi* aAppUi);       //这是同一个c类的二次构造相关的内容

              ~CIeAppView();     //C类必须的析构函数，在里面将该视图的不可自动消除的成员变量进行释放

              void ConstructL(const TRect& aRect,CQikAppUi* aAppUi); //第二阶段的构造，这个里面含有很多比较重要的信息，稍后我会在详细的app中介绍

              CIeAppView::CIeAppView(const TInt &aPoint);

              TInt iPoint;

              TInt iAddInt;

        private:

              void Draw(const TRect& /* aRect */) const;    //CCoeControl提供的draw方法

              void FocusChanged(TDrawNow aDrawNow);  //触发焦点后调用的方法同样由ccoecontrol提供

         // Virtual, defined by CCoeControl; replaces the default implementation

         // provided by CCoeControl.

             CEikTabButton* iButton;                  //某非自主窗体的控件

              CQikAppUi* iAppUi;

};

 

下面我们来看一下其cpp的内容：

#include "CIe.h"

 

下面的这是一个返回CIeAppView指针的方法，它里面使用了两段构造后，返回成功构造的对象指针.

CIeAppView* CIeAppView::NewL(const TRect& aRect,const TInt &aInt,CQikAppUi* aAppUi)

{

       CIeAppView* cIe = new(ELeave) CIeAppView(aInt);

       CleanupStack::PushL(cIe);     //将对象推入清理栈

       cIe->ConstructL(aRect,aAppUi);

       CleanupStack::Pop();         //清除清理栈

       return cIe;     

}

 

void CIeAppView::ConstructL(const TRect& aRect,CQikAppUi* aAppUi)

{

 

iAppUi = aAppUi;

//通过下面这句为控件创建一个自身的窗体.

CreateWindowL();

 

//设置绘画的区域，同时它还会调用SizeChanged()方法

SetRect(aRect); 

 

//下面这是一个控件的构造过程

iButton = CEikTabButton::NewL(aRect);

 

/*

使用AppUi将控件加入事件栈中，使做为寄宿的控件能够获得事件,同样在AppUi的析构函数中要调调用RemoveFromStackL().

*/

iAppUi->AddToStackL(iButton);

 

//看，下面这句为寄宿控件设置了父窗体

iButton->SetContainerWindowL(*this);

 

/*

下面这句通知应用一切备好准备进行绘图，当然你也可以覆盖此方法，写入一些在进行draw之前需要准备的工作.

*/

ActivateL();

}

 

CIeAppView::CIeAppView(const TInt &aPoint)

{

              iPoint = aPoint;

}

 

CIeAppView::~CIeAppView()

{

       delete iButton;

}

 

void CIeAppView:: FocusChanged(TDrawNow aDrawNow)

{

       if(IsFocused()){

              iButton->SetFocus(ETrue,EDrawNow);

       }

}

 

void CIeAppView::Draw(const TRect& /* aRect */) const

{

       CWindowGc& gc = SystemGc();

}

 

可能，看上面会有点晕，这个成员数据iButton究竟是一个怎样的控件，首先在下面没有进行解释之前，我们讨论一下复合寄宿控件(container)和非复合寄宿控件的概念。

1.复合控件

a)也就是含用一个以上寄宿控件的控件，我们通常称之为container。虽然说我们从表面上看一个控件button加起来很easy，只需要配置一下然后再加入command id就可以，实际上在symbian中也是一个绘图的过程，不过需要我们注意的是container本身不会绘图，具体的绘图由下面的子控件的draw来完成。

做为复合控件必须要改写CConeControl中的两个方法

      

       TInt CountComponentControls() const;            //返回子控件个数

       CCoeControl* ComponentControls(Tint aIndex) const;//按控件索引返回复合控件中的某一控件指针.

b)非container的寄宿控件同复合控件相反，它不用去改写上面的两个方法，更多的用处是在自身的draw方法中下功夫.

class CEikTabButton:public CCoeControl

{

       public:

        static CEikTabButton* NewL(const TRect aRect);

        void ConstructL(const TRect aRect);

        ~CEikTabButton();

 

       private:

         TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent,TEventCode aType);

         void Draw(const TRect& aRect) const;

         void FocusChanged(TDrawNow aDrawNow);

         void SizeChanged();

 

         /*

Tint CountComponentControls() const;

         CCoeControl* ComponentControl(TInt aIndex) const;

         */

 

         CFbsBitmap* iButtonImg;

         TRect iSmileyRect;

         CEikLabel* iLabel;

        

};

 

 

#include "CIE.h"

 

CEikTabButton* CEikTabButton::NewL(const TRect aRect)

{

         CEikTabButton* aButton = new(ELeave) CEikTabButton();

         CleanupStack::PushL(aButton);

         aButton->ConstructL(aRect);

         CleanupStack::Pop(aButton);

         return aButton;

}

 

void CEikTabButton::ConstructL(const TRect aRect)

{

              //CreateWindowL();

              iButtonImg =new (ELeave) CFbsBitmap();

              _LIT(aPath,"Z://system//apps//cie//cie.mbm");

iButtonImg->Load(aPath,EMbmCieA,ETrue);

 

              //iLabel = new(ELeave) CEikLabel();

              //iLabel->SetContainerWindowL(*this);      

              //ActivateL();        

              SetRect(TRect(0,0,40,40));

             

}

 

CEikTabButton::~CEikTabButton()

{

       delete iButtonImg;

       //delete iLabel;

}

 

 void CEikTabButton::SizeChanged()

 {

     

       /*iSmileyRect=Rect();

// Allow room for the focus rectangle round the outside

iSmileyRect.Shrink(3,3);

       iSmileyRect.SetRect(iSmileyRect.iTl+TPoint(100/4, 100/2),TSize(100/2, 100/3));

       iSmileyRect.SetRect(iSmileyRect.iTl+TPoint(100/4, 100*2/3),TSize(100/2, 100/3));

       */

 }

 

TKeyResponse CEikTabButton::OfferKeyEventL(const TKeyEvent& aKeyEvent,TEventCode aType)

 {

      iEikonEnv->InfoMsg(_L("A"));

 }

 

 void CEikTabButton::Draw(const TRect& aRect) const

 {

      CWindowGc& gc=SystemGc();

gc.Clear(Rect());

gc.SetClippingRect(Rect());

gc.DrawBitmap(Rect(),iButtonImg);

}

 

 

 void CEikTabButton::FocusChanged(TDrawNow aDrawNow)

 {

      if(aDrawNow)

      {

             DrawNow();

      }

 }

 

 

至此，寄宿控件可以正常显示在appview中了。稍后，我们介绍如何让这些寄宿控件能够获得事件.