CCoeControl是所有控件的基类,它封装了一个控件的基本属性和功能。编写简单控件涉及到的函数主要有以下三类:初始化、绘图及用户输入处理。下面是一个简单控件的声明。
图形上下文保存有下列对绘图函数有着重要影响的上下文项。
1. 画笔: pen定义绘图模式(颜色、样式和大小),它用来绘制线、轮廓以及文本。
2. 刷子:brush定义了填充模式、背景色或样式。
3. 字体:font定义了用来绘制文本的字体。图形上下文没有默认的字体,因此在使用相关文本函数前,必须调用
UseFont()设置字体。另外,在使用完字体后必须调用
DiscardFont()来删除字体,以免内存泄漏。
4. 当前位置:当前位置由
MoveTo()和各种
DrawXxxTo()成员函数来设置(绝对位置),并由
MoveBy()和
DrawXxxBy()移动(相对位置)。
5. 原点:origin定义了相对与设备原点的偏移,绘图时使用该偏移,可以使用
SetOrigin()来设置原点。默认的原点为(0,0)。
6. 剪辑区域:clipping region定义图形操作中想要剪辑的区域。可以指定一个简单的矩形或任意复杂的区域。设置剪辑区域之后,只有落在剪辑区域内的绘图操作才被显示出来。可以使用
SetClippingRect()函数来设置矩形剪辑区域,使用
CancelClippingRect()来取消它;使用
SetClippingRegion()函数来设置任意复杂的剪辑区域,使用
CancelClippingRegion()来取消它;
使用Reset()可以将所有的上下文项设置为默认值。
系统调用Draw()函数之前会自动调用Reset()函数,因此通常不需要在控件中显式调用该函数。
在设置好图形上下文后,可以调用各种绘图函数在控件上进行绘图。几乎所有的绘图函数都被设计为能够成功执行,因而一般不返回任何值。这使得多个绘图函数能够被打包为一条消息发送到服务器执行。如果绘图函数有返回值的话,这将是不可能的。
(1) 点和线.这些函数使用当前画笔。
virtual void Plot(const TPoint& aPoint);
virtual void DrawLine(const TPoint& aPnt1, const TPoint& aPnt2);
virtual void DrawLineTo(const TPoint& aPoint);
virtual void DrawLineBy(const TPoint& aVector);
virtual void DrawArc(const TRect& aRect, const TPoint& aStart, const TPoint& aEnd);
virtual void DrawPolyLine(const CArrayFix<TPoint>* aPointList);
virtual void DrawPolyLine(const TPoint* aPointList, TInt aNumPoints);
(2) 实心轮廓图形.这些函数使用画笔和画刷,画笔用来绘制轮廓,刷子用来填充轮廓内部。
virtual void DrawPie(const TRect& aRect, const TPoint& aStart, const TPoint& aEnd);
virtual void DrawEllipse(const TRect& aRect);
virtual void DrawRect(const TRect& aRect);
virtual void DrawRoundRect(const TRect& aRect, const TSize& aEllipse);
virtual TInt DrawPolygon(const CArrayFix<TPoint>* aPointList, TFillRule aFillRule = EAlternate);
virtual TInt DrawPolygon(const TPoint* aPointList, TInt aNumPoints, TFillRule aFillRule = EAlternate);
(3) 位图.能够以1:1的比例或者拉伸到所指定矩形区域的大小来绘制位图。
virtual void DrawBitmap(const TPoint& aTopLeft, const CFbsBitmap* aSource);
virtual void DrawBitmap(const TRect& aDestRect, const CFbsBitmap* aSource);
virtual void DrawBitmap(const TRect& aDestRect, const CFbsBitmap* aSource,const TRect& aSourceRect);
(4) 文本.使用当前字体。
virtual void DrawText(const TDesc& aString, const TPoint& aPosition);
virtual void DrawText(const TDesc& aString, const TRect& aBox, TInt aBaselineOffset, TTextAlign aHoriz = ELeft, TInt aLeftMrg = 0);
绘图和重绘:
在GUI程序中,所有的绘图都在控件上完成,绘图是由控件的Draw()函数来完成的,其声明如下virtual void Draw(const TRect& aRect) const;
基类CCoeControl的Draw()为空,因此在编写控件时必须实现该函数,否则控件将不可见。Draw()是由应用程序框架来调用,一般不应在应用程序中直接调用Draw()。控件不只是在初始化绘制它们的外观,而且在它发生变化时或者系统要求重绘(redraw)时进行重绘。按照重绘的触发源来划分,控件的重绘分为两种:系统发起的重绘和应用程序发起的重绘。系统发起的重绘处理从窗口服务器开始,它检测并判断何时需要重绘哪部分窗口。实际上,它维护窗口上的一个无效区域,并向拥有窗口的应用程序发送一个重绘事件,要求它重绘无效区域。应用程序发起的重绘处理由应用程序触发,它可以根据需要采用如下方法来实现(这些函数最终都是通过调用Draw()来实现的):void CCoeControl::DrawNow();立即重绘整个控件;void CCoeControl::DrawDeferred()const;一旦有机会就重绘整个控件;void RWindow::Invalidate(const TRect&);一旦有机会就重绘由参数指定的矩形区域。然而通过将重绘活动限制在矩形中,几乎不会节省很多开销,因此,编写大多数控件时,一般忽略传递限制矩形参数。 用户输入处理: Symbian OS中处理用户输入的两个基本函数是OfferKeyEventL()和HandlePointerEventL()。由于Series60平台不支持笔写输入,所以主要使用OfferKeyEventL()。下面是一个简单控件处理按键事件的代码: TKeyResponse CSimpleControl::OfferKeyEventL(const TKenEvent& aKeyEvent, TEventCode aType) { switch(aType) { case: EEventKey: if (aKeyEvent.iScanCode == EStdKeyNkp5 || aKeyEvent.iScanCode == EStdKeyEnter) iMyGameEngine->Fire(); break; case: EEventKeyDown: //.... case: EEventKeyUp: //.... } return EKeyWasNotConsumed; } |
Symbian控件开发之CCoeControl
最新推荐文章于 2024-10-16 18:32:57 发布