Symbian控件架构的详细介绍

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);
voidSizeChanged();
/*
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中了。稍后,我们介绍如何让这些寄宿控件能够获得事件.