深入理解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 中了。稍后，我们介绍如何让这些寄宿控件能够获得事件 .