Symbian OS 控件开发之 CCoeControl

核心提示：图形上下文保存有下列对绘图函数有着重要影响的上下文项，1. 画笔： pen定义绘图模式(颜色、样式和大小)，Symbian OS 控件开发之 CCoeControl(2)，它用来绘制线、轮廓以及文本，2. 刷子：brush定义了填充模式、背景色或样式，如果绘图函数有返回值的话，这将是不可能的，3. 字体：font定义了

图形上下文保存有下列对绘图函数有着重要影响的上下文项。

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* aPointList);