基于控件的传统symbian OS架构之调试小结

基于控件的传统symbian OS架构之调试小结
之前写过一个关于symbian常用程序架构的帖子,不过当时是在简单的看了看书本的条件下写的,仅仅是当时做的一个笔记而已,并没有多少自己的感想体会在里面。当然现在也不能就对传统的symbian os架构很了解了,因为毕竟没有做太多深入的研究试验,仅仅是根据自己的想法做了几个小程序而已。
 
从四个小程序上来分析:
 
一、在屏幕上显示两个Label
这是最最基本的了。
关键的就是创建一个容器Container(实际上就是一个拥有窗口的复合控件而已)和一个UI其中Container继承自控件基类CCoeControl,而UI继承自CAknAppUi,这都是必须的。另外,如果Container里的控件,比如编辑框想接收用户事件的话,那么Container同时还要继承?????????因为我的容器里面只有两个Label,所以也就不需要继承这个类了。
(1)先看容器类Container的内容:
因为容器Container里包含两个Label,一定要注意,将两个Label 的指针设为Container类的私有成员变量即:
private :
     CEikLabel* iLabel;
     CEikLabel* iToDoLabel;
当然这是在Container类的头文件里声明的。
然后就是看Container的四个方法,这四个都需要我们重写,否则容器中的两个Label控件不会显示。它们分别是:
void Draw(const TRect& aRect) const;
virtual CCoeControl* ComponentControl(TInt aIndex) const;
virtual TInt CountComponentControls() const;
void SizeChanged();
 
在本例中,我是这样重写这四个方法的:
CCoeControl* CHelloWorldBasicAppView::ComponentControl(TInt aIndex) const
{
     switch(aIndex)
     {
     case 0:
         return iLabel;
     case 1:
         return iToDoLabel;
     default:
         return NULL;
     }
}
获取容器中每个控件的指针。
 
void CHelloWorldBasicAppView::SizeChanged()
{
     //设置标签的位置
     iLabel->SetExtent( TPoint(10,10), iLabel->MinimumSize() );
    iToDoLabel->SetExtent( TPoint(10,100), iToDoLabel->MinimumSize() );
    
}
SetExtent()方法设置Label的位置。
开始时,我认为,Label的大小不会改变,所以不需要重写该方法,但事实证明,即使容器中的控件大小不会改变,我们也必须重写这两个方法。如果不,那么这两个Label就不会显示。
 
TInt CHelloWorldBasicAppView::CountComponentControls() const
{
     return 2;
}
返回容器中控件的数目,在这里有两个 Label,所以返回2。
 
void CHelloWorldBasicAppView::Draw(const TRect& aRect) const
{
    // Get the standard graphics context
    CWindowGc& gc = SystemGc();
    // Gets the control's extent
    TRect rect = Rect();
    // Clears the screen
    gc.Clear(rect);
     //设置笔刷
gc.SetPenStyle( CGraphicsContext::ENullPen );
    gc.SetBrushColor( KRgbRed ); //红色
    gc.SetBrushStyle( CGraphicsContext::ESolidBrush );
    gc.DrawRect( aRect );
 }
将整个窗口的aRect范围,涂成红色。通过一个TRect对象可以设置Draw的区域即:gc.DrawRect( aRect );也就是说,并不一定要绘制整个窗口。
 
下面看 Container的ConstructL方法:
void CHelloWorldBasicAppView::ConstructL(const TRect& aRect)
    {
     // Create a window for this application view
     CreateWindowL();//复合控件创建窗口
 
     iLabel=new(ELeave) CEikLabel;
     iLabel->SetContainerWindowL(*this);//将不拥有窗口的控件和窗口关联
     iLabel->SetTextL(_L("iLabel"));
     iLabel->SetUnderlining(ETrue);
 
     iToDoLabel=new(ELeave) CEikLabel;
     iToDoLabel->SetContainerWindowL(*this);
     iToDoLabel->SetTextL(_L("iToDoLabel"));
 
    // Set the windows size
    SetRect(aRect);
 
    // Activate the window, which makes it ready to be drawn
    ActivateL();
}
首先,我们给这个容器创建一个窗口,然后分别创建两个 Label的实例iLabel和iToDoLabel,这其中用到一个方法SetContainerWindowL(*this);,表示将这两个控件显示在那个窗口上,而参数表示的是容器Container,而不是一个Rwindow,这实际上是调用的是CcoeControl中的方法:
virtual void SetContainerWindowL(const CCoeControl& aContainer);
通过看这个函数原型就知道了没有必要非要传递一个Rwindow实例,我们也可以传递一个拥有窗口的容器,而在这里容器Container就是一个拥有窗口的CCoeControl实例,因为我们调用了方法CreateWindowL();
当然也可以给该方法传递一个 RWindow实例,即调用CCoeControl的重载方法:
void SetContainerWindowL(RWindow& aWindow);
 
然后设置我们创建的窗口的显示范围SetRect(aRect);,一般是全屏,当然我们也可以设置一个TRect实例,比如:TRect(TPoint(0,0),TSize(100,100)),但是这种情况下,就会看到,我们程序的窗口没有占满整个屏幕,也就是说,仅有TRect(TPoint(0,0),TSize(100,100))的区域来显示我们的程序,而屏幕上剩余的范围还会显示原来的,这样子就比较奇怪,比较难看了。
 
最后激活窗口ActivateL();也就是说调用容器的Draw()、SizeChanged()等函数,从而开始绘制窗口。
 
最后就是容器Container类的析构函数:
CHelloWorldBasicAppView::~CHelloWorldBasicAppView()
{
     if(iLabel)
     {
         delete iLabel;
          iLabel=NULL;
     }
     if(iToDoLabel)
     {
         delete iToDoLabel;
          iToDoLabel=NULL;
     }
}
这个析构函数的主要作用是销毁我们容器中创建的两个 Label实例iLabel和iToDoLabel。
 
(2)看UI的内容
其实主要就是UI的ConstructL()方法和析构函数,之所以有析构函数,因为实际上UI也是一个C类。
void CHelloWorldBasicAppUi::ConstructL()
{
    BaseConstructL();
    iAppView = CHelloWorldBasicAppView::NewL(ClientRect());
iAppView->SetMopParent( this );
    AddToStackL(iAppView);
}
首先创建UI的框架即调用方法BaseConstructL();,然后创建容器Container实例,实际上就是这里的iAppView。
接下来的的 SetMopParent( this );和AddToStackL(iAppView);在本例中并不是必须的:
SetMopParent( this );是为了设置父控件用的。据网友pan讲:通过这个方法可以设置控件之间的父子关系,然后在子控件中就可以访问父控件或其他子控件,父控件中也可以访问子控件。需要注意的就是要讲这个方法和SetContainerWindowL()区分开。
AddToStackL(iAppView);将容器放到栈顶,从而可以接收用户的事件,如果想让其他容器接收事件的话,就可以通过另一个方法,RemoveFromStatck(iAppView)将当前容器从栈顶移出,然后在将其他容器移入该栈顶即:AddToStackL(iAppView2);
 
CHelloWorldBasicAppUi::~CHelloWorldBasicAppUi()
{
    if (iAppView)
        {
        iEikonEnv->RemoveFromStack(iAppView);
        delete iAppView;//调用容器Container的析构函数,销毁容器对象即iAppView
        iAppView = NULL;//注意,一定要将指针置空,否则就会称为悬空指针,也就是野指针。
        }
}
在析构函数中销毁创建的容器实例。
 
需要注意:容器实例iAppView必须是UI类的私有成员,即:
private:
       CHelloWorldBasicAppView* iAppView;
 
小结:这里面出现几个概念,比如屏幕、窗口、容器、复合控件等,比较容易让人混淆。我的理解是这样子的:屏幕就只有一个,也就是手机的显示屏,是一个物理概念;而窗口是逻辑上的概念,一个程序里我们可以创建多个窗口,下面的一个例子我就来说明这个问题;容器和复合控件都是继承自控件基类CCoeControl,并且它们的类定义中都有子控件成员,不同之处就是容器拥有自己的窗口,而复合控件没有,我们可以把复合控件加到其他的复合控件或容器上,我也会在下面的例子里加以实现。
 
二、屏幕上面切换显示两个窗口
每个窗口都有两个Label。
最开始,我是想这样来实现:让第一个iAppView创建一个窗口,而第二个iAppView2(实际上就是一个复合控件)不再创建新的,而是共用iAppView创建的窗口。试验的时候,在UI的ConstructL()方法里,先创建iAppView,在将拥有窗口的容器iAppView作为参数传递到iAppView2的构造函数中,但却发现并不能实现。
因此,我只能也给iAppView2也创建一个窗口,看这两个容器类的构造函数如下:
void CHelloWorldBasicAppView::ConstructL(const TRect& aRect)
    {
    // Create a window for this application view
    CreateWindowL();//复合控件创建窗口
 
     iLabel=new(ELeave) CEikLabel;
     iLabel->SetContainerWindowL(*this);//将不拥有窗口的控件和窗口关联
     iLabel->SetTextL(_L("iLabel"));
     iLabel->SetUnderlining(ETrue);
 
     iToDoLabel=new(ELeave) CEikLabel;
     iToDoLabel->SetContainerWindowL(*this);
     iToDoLabel->SetTextL(_L("iToDoLabel"));
 
    // Set the windows size
    SetRect(aRect);
 
    // Activate the window, which makes it ready to be drawn
    ActivateL();
}
 
void CHelloWorldBasicAppView2::ConstructL(const TRect& aRect,CHelloWorldBasicAppView* iAppView)
    {
    // Create a window for this application view
    CreateWindowL();//复合控件创建窗口
 
     iLabel2=new(ELeave) CEikLabel;
     iLabel2->SetContainerWindowL(*iAppView);//将不拥有窗口的控件和窗口关联
     iLabel2->SetTextL(_L("iLabel2"));
     iLabel2->SetUnderlining(ETrue);
 
     iToDoLabel2=new(ELeave) CEikLabel;
     iToDoLabel2->SetContainerWindowL(*iAppView);
     iToDoLabel2->SetTextL(_L("iToDoLabel2"));
 
    // Set the windows size
    SetRect(aRect);
 
    // Activate the window, which makes it ready to be drawn
    ActivateL();
}
通过对照发现,两个构造函数中都创建了窗口,并进行了激活。注意就是它们的窗口范围都是整个屏幕。
现在的问题是:如何轮换显示两个窗口呢?
可以通过方法: iAppView->MakeVisible( EFalse );或iAppView->MakeVisible( ETrue );来实现窗口的是否显示,来在一个屏幕上切换显示两个范围都是占满个屏幕的窗口。
即看 UI的构造函数:
void CHelloWorldBasicAppUi::ConstructL()
    {
    BaseConstructL();
    iAppView = CHelloWorldBasicAppView::NewL(ClientRect());
iAppView->MakeVisible( EFalse );//暂时不显示容器iAppView
iAppView2 = CHelloWorldBasicAppView2::NewL(ClientRect());
    }
三、在一个屏幕上同时显示两个窗口
在设定窗口的范围上,iAppView占屏幕的上半部分,而iAppView2占屏幕的下半部分。其他的和上面一样,当然也就不需要MakeVisible()这个方法了,呵呵。
主要的区别就是UI的构造函数:
void CHelloWorldBasicAppUi::ConstructL()
    {
    BaseConstructL();
TRect rect = ClientRect();
    iAppView = CHelloWorldBasicAppView::NewL(TRect(rect.iTl.iX,
                                                           rect.iTl.iY,
                                                           rect.Width(),
                                                           rect.Height()/2+rect.iTl.iY));
 
     iAppView2 = CHelloWorldBasicAppView2::NewL(TRect(rect.iTl.iX,
                                                              rect.Height()/2+rect.iTl.iY,
                                                              rect.Width(),
                                                              rect.iBr.iY));
}
 
这两个容器的窗口分别占屏幕的上下各一半。
 
四、让 iAppView2仅作为一个复合控件,并称为容器iAppView的一个子控件,和iAppView在一个窗口上显示。
这个地方要比上面复杂一些,我在这里贴出iAppView2的ConstructL()代码:
void CHelloWorldBasicAppView2::ConstructL(const TRect& aRect)
    {
     iLabel2=new(ELeave) CEikLabel;
     iLabel2->SetContainerWindowL(*this);//将不拥有窗口的控件和窗口关联
     iLabel2->SetTextL(_L("iLabel2"));
     iLabel2->SetUnderlining(ETrue);
 
     iToDoLabel2=new(ELeave) CEikLabel;
     iToDoLabel2->SetContainerWindowL(*this);
     iToDoLabel2->SetTextL(_L("iToDoLabel2"));
}
 
可以看到,仅仅是创建了两个 Label控件而已,而没有之前的创建窗口CreateWindowL()和激活窗口ActiveWindowL()方法了,因为这里的iAppView2仅仅是作为一个复合控件而已,所以就不需要创建窗口了。其它的方法即SizeChanged()、Draw()、CountComponentControls()和ComponentControl()都是不变的。
上面的iLabel2->SetContainerWindowL(* this);,参数传递的是当前复合控件对象,虽然复合控件并不拥有窗口,但是通过复合控件iAppView2的SetContainerWindowL()方法中的参数是拥有窗口的iAppView,也就是通过层层上传,最后,这两个Label控件也和要显示在上面的窗口联系起来了。而不是把iAppView直接传递给这两个Label的SetContainerWindowL()方法,这里必须注意。
 
因为要将复合控件iAppView2作为容器iAppView的一个子控件,所以iAppView2要作为iAppView的容器类的一个成员变量即:
private :
     CEikLabel* iLabel;
     CEikLabel* iToDoLabel;
     CHelloWorldBasicAppView2* iAppView2;//多了复合控件iAppView2这个私有成员变量。
因为iAppView的容器类多了一个新的子控件,即iAppView2,所以这个类的ConstructL()、SizeChanged()、CountComponentControls()、ComponentControl()以及析构函数~ChelloWorldBasicAppView都需要修改,如下:
 
void CHelloWorldBasicAppView::ConstructL(const TRect& aRect)
    {
    // Create a window for this application view
     CreateWindowL();//复合控件创建窗口
 
     iLabel=new(ELeave) CEikLabel;
     iLabel->SetContainerWindowL(*this);//将不拥有窗口的控件和窗口关联
     iLabel->SetTextL(_L("iLabel"));
     iLabel->SetUnderlining(ETrue);
 
     iToDoLabel=new(ELeave) CEikLabel;
     iToDoLabel->SetContainerWindowL(*this);
     iToDoLabel->SetTextL(_L("iToDoLabel"));
     //多了下面两行代码
     iAppView2=CHelloWorldBasicAppView2::NewL(TRect(TPoint(0,100),TSize(200,200)));
     iAppView2->SetContainerWindowL(*this);
    
    // Set the windows size
    SetRect(aRect);
 
    // Activate the window, which makes it ready to be drawn
    ActivateL();
}
 
――――――――――――――――――――――――――――――――――――
void CHelloWorldBasicAppView::SizeChanged()
{
     //设置控件的位置
iLabel->SetExtent( TPoint(10,10), iLabel->MinimumSize() );
iToDoLabel->SetExtent( TPoint(10,30), iToDoLabel->MinimumSize() );
//多了下面一行代码,TPoint(10,60)相对于窗口左上角
iAppView2->SetExtent( TPoint(10,60), iToDoLabel->MinimumSize() );
    
}
 
―――――――――――――――――――――――――――――――――――――――――――
TInt CHelloWorldBasicAppView::CountComponentControls() const
{
     return 3;
}
返回是3,不是4(虽然复合控件有两个子控件)。
――――――――――――――――――――――――――――――――――――――――――
CCoeControl* CHelloWorldBasicAppView::ComponentControl(TInt aIndex) const
{
     switch(aIndex)
     {
     case 0:
         return iLabel;
     case 1:
         return iToDoLabel;
     //多了下面两行
     case 2:
         return iAppView2;
     default:
         return NULL;
     }
}
 
――――――――――――――――――――――――――――――――――――
CHelloWorldBasicAppView::~CHelloWorldBasicAppView()
{
     if(iLabel)
     {
         delete iLabel;
          iLabel=NULL;
     }
 
     if(iToDoLabel)
     {
         delete iToDoLabel;
          iToDoLabel=NULL;
     }
     //多了下面几行
     if(iAppView2)
     {
         delete iAppView2;
          iAppView2=NULL;
     }
}
 
 
问题:
1、 draw()方法,不需要做任何改变。我开始想,可能需要加一个iAppView2.DrawNow()之类的代码,启动绘制复合控件iAppView2的代码,实际是多此一举的。系统会自动运行复合控件的draw()等四个方法。
2、   复合控件以及复合控件中的两个 Label子控件显示的坐标问题,一定记住,它们都是相对于窗口左上角的坐标位置,我曾经将两个子控件的坐标设为相对于它们所属的复合控件了,结果因为超出屏幕范围,没有显示出来。另外屏幕的范围大约在(0,0)--(120,150)之间,如果设置坐标时超出这个范围,就显示不出来了。
 
当然这只是一些最基本的架构问题,也没有显示一些比较复杂的控件,在这里只是起个熟悉传统程序架构的作用,不正之处,还请各位网友指正。
 
 

你可能感兴趣的:(Symbian,symbian,os,application,delete,null,ui)