GDI+ —— Tcanvas 类属性及方法.......
delphi TCanvas类
类关系 TObject-> TPersistent
对那些作图对象，可使用TCanvas对象作为画布。标准的window控件，例如编辑控件和列表框控件，当它们被Windows画出来时，并不需要一块画布。在创建一幅图像时，TCanvas对象提供有用的属性、方法和事件，主要通过以下方法：
指定需要使用的刷子、画笔和字体类型。
对各类形状和线条进行作图和填充。
输入文体。
对图像进行着色。
对当前图像的变化能作出反应。
TCanvas有两个子类，即TControlCanvas和TMetafileCanvas，它们对控件图像的作图和创建对象的图元文件图像有所帮助。
属性列表
Brush 决定画布填充图形的背景颜色和填充图案的模式
ClipRect 指定剪贴矩形的边界
CopyMode 确定如何将复制的图像放到画布上面
Font 指定使用文体的字体
Handle 是针对画布的Windows GDI句柄
LockCount 表示画布被锁定的次数
Pen 指定使用的画笔种类
PenPos 指定画笔当前的作图位置
Pixels 指定当前ClipRect中点的颜色
方法列表
~TCanvas 释放TCanvas占用的内存
Arc 在图片上画出一段弧线
BrushCopy 制位图的一部分到位于画布上的矩形中
Chord 画一个由一条直线和一个椭圆相交所的的闭合图形
CopyRect 将另一画布上图形的一部分复制到这个画布上
Draw 在画布上输出由Graphic参数指定的图像
DrawFocusRect 画一个矩形框表示矩形内的控件对象具有输入焦点
Ellipse 在画布上画椭圆
FillRect 使用当前刷子填充画布上指定的矩形
FloodFill 使用当前刷子填充画布上的一块区域
FraneRect 画出一个矩形的边框
LineTo 在画布上画一条从当前画笔位置到指定点（x, y）的直线
Lock 使其他线条不在画布上画出
MoveTo 使当前作图位置移到点（x, y）
Pie 在画布上画一个扇形
PolyBezier 画一簇Bezier曲线
PolyBezierTo 画一簇Bezier曲线并更新PenPos的值
Polygon 在画布上画出闭合图形
Polyine 在画布上画出一系列链接点数组中的每一个点的直线
Rectangle 在画布上画出一个矩形
Refresh 从设备场境里删除 Pen、Brush 以及 Font
RoundRect 在画布上画出一园角的矩形
StretchDraw 画出由 raphic 参数指定的图像
TCanvas 创建一介 TCanvas 对象的实例
TextExtent 返回字符串的像素宽度和高度
TextHeight 返回字符串的像素高度
TextOut 在画布上从点（x,y)处开始输出一字符串
TextRect 在剪切矩形区内输出字符串
TextWidth 返回字符串的像素宽度
TryLock 调用TryLock 将锁定画布
Unlock 使LockCount 属性值减少
事件列表
OnChange 当画布上的图像刚发生变化时OnChange事件发生
OnChanging 当画布上的图像刚发生变化时OnChanging事件发生
属性
TCanvas::Brush
决定画布填充图形的背景颜色和填充图案模式。
__property TBrush* Brush = { read =FBrush, write =SetBrush };
通过设置 Brush属性的属性，指定作图背景颜色和填充图案的模式。Brush 属性值为TBrush 对象。当在画布上填充一个空间时，通过设置TBrush 对象的属性，可以指定可以使用的颜色、模式或者位图。
注意：设置Brush 属性是为分配指定的TBrush 对象，而不是替代当前的 TBrush 对象。
TCanvas:::ClipRect
指定剪贴矩形的边界。
__property Windows:::TRect ClipRect = {read =GetClipRect };
使用ClipRect权属性用来限定画布的作图区域。任何坐标在ClipRect 属性以外的作图将被剪切掉并且不会出现在图像中，例如，在一个较小的框中画一个大圆的一部分，首先画框，然后对由框的内边界限定的矩形进行ClipRect属性设置 。此时，画整个圆将显示在框内部分。
当处理窗体的OnPaint 事件时，画布的ClipRect 属性被设置成所需着色的矩形。不与ClipRect 重叠的图像部分，不必画出。因此，OnPaint 例程能够使用 ClipRect 属性的数值，对着色进行优化，并加速应用软件的全面运行。
TCanvas::CopyMode
确定如何将复制的图像放到画布上面。
__property int Copy Mide = {read = FCopyMode, write = FCopyMode, default = 13369376 };
设置copyMode属性，可以改变画出的图像到画布上面的路径。当使用CpyReet 方法从另外的画布上复制图像时，使用CopyMode属性。当TBitmap 对象画它们自身到一个画布上时，CopyNode属性还被TBitmap对象使用。
下表给出了CopyMode属性可能的取值，并对每一取值进行了描述。
取值 说 明
cmBlackness 用黑色填充画布的矩形目标
cmDstInvert 忽略源图，将画布上的图像反转
cmMergeCopy 将画布上的图像与源位图进行AND操作
cmMergePaint 将画布上的图像与反转的源位图进行OR操作
cmNotSrcCopy 复制反转的源位图与画布
cmNotSrcErsae 将画布上的图像与源位图进行OR操作，然后再反转
cmPatCopy 复制源式样至画布
cmPatInvert 将画布上的图像与源式样进行XOR操作
cmPatPaint 使用OR操作使反转的源位图与源式样结合，并将操作结果与画布上的图像进行OR操作
cmSsrcAnd 将画布上的图像与源位图进行AND操作
cmSrcCopy 复制源位图至画布
cmSrcErase 将画布上的图像进行反转，然后将其与源位图进行XOR操作
cmSrcInvert 将画布上的图像与源位图进行OR操作
cmWhiteness 用白色填充画布上的矩形目标
TCanvas::Font
当在图像上写的文本时，使用Font属性指定使用文本的字体
__property TFont* Font = { read = FFont, write = SetFont } ;
对图像上的文本，使用Font属性可以指定使用文本的字体。Font 属性的数值是TRont 对象。设置TFont对象的属性，可以指定使用字体的外观、颜色、大小以及风格等。
注意：仅对指定TFont对象的 Font 属性进行指定，而不是替代当前的TFont对象。
TCanvas::HandIe
是针对画布的Windows GDI句柄。
__property HDC HandIe = { read = GetHandIe write = SetHandIe ,nodefauIt } ;
对于卷入画布的设备场境，必须设置HDC 的Handle 属性。当窗口控件对Windows 着色信息进行响应时，绘图所需的HDC 即转化为PrtDeviceContext 方法 。在其他情况下，通过调用控件的GetDeviceContext方法，也能获得HDC。此外，对打印机或者存储器，Windows 还提供了能够获得HDC的API调用方法。
读Handle 属性可以对由使用需要设备场境句柄的进行API调用的TCanvas 对象提供绘图设备进行补充。绝大多数的Windows GDI调用，需要HDC。
TCancas对象没有自己的HDC。应用软件必须建立一个HDC，并对Handle 属性进行设置。当画布不再需要时，应用软件应释放HDC。对已有效一个有HDC画布，进行Handle属性进行设置时，将不能自动释放初始的HDC。
注意：TCanvas 对象的一些字体，如TControlCanvas , 有其自己的HDC。不要为这些对象设置Handle属性。它们使用并释放自己的Handle属性。
TCanvas::LocKcount
表示画布被锁定的次数，以避免与其他线条相冲突。
__properrty int LockCount = {read = FLockCount,nodefault }:
读LockCount属性可以查明画布是否被锁定。每当调用Lock方法防止画布与其他线条相冲突时，LockCount属性增加。调用Unlock方法时，LockCount 属性减少。当LockCount属性为0时，其他线条可以在画布上画出。
TCanvas::Pen
指定画布为画线和画图形轮廓而使用的画笔种类。
__property TPen * Pen + {read = FPen, write =SetPen };
在一幅图像中，设置Pen 属性可指定画线和画图形轮廓而使用的画笔种类。Pen属性的数值是TPen对象。设置TPeb对象的属性，可以指定画笔的颜色、风格、宽度以及样式等。
注意：仅对指定TPen 对象的Pen属性进行设置，而不是替代当前的TPen对象。
TCanvas::PenPos
用来指定画笔当前的作图位置。
__property tag POINT penPos = {read = GetPenPos , write = SetPos },
读 PernPos 可以知道画笔当前的傻图位置。它是用 LineTo 方法作图的起始点位置。设置 PenPos 属性相当于调用 MoveTo 方法 。
TCanvas::Pixels
指定当前 ClipRect是中点颜色。
__property TColor Tixels [ int Y ] = { read = Get Pixel , write = SetPixe } ';
读取Tixels 读属性可以知道位于具体像素位置的画面颜色。写Pixels属性可以改变画面上某个特定像素的颜色。使用Pixels 属性可以细化图像效果。Pixels 属性还可以用于确定被FillRect方法使用的颜色。
不是每一个设备场境都支持Pixels属性。这样的设备场境，读出的Pixels属性返回值为--- 1。则对这样的设备场境进行Pixels 属性设置是没有用的。
注意： Pixels属性仅对位于当前Cliprect 数值内的像素有效。
方法
TCanvas::~TCanvas
删除一个TCanvas的实例。
__fastcall virtual ~ TCanvas(void);
在应用程序中，不要直接调用~TCanvas，而应调用delete。
~TCanvas首先释放为Font、Brush和Pen属性创建的TFont、TBrush和TPen对象。然后再释放TCanvas对象的内存。
TCanvas::Arc
沿由指定矩形确定的椭圆的边，可以在图片上画出一段孤线。
void __fastcall Arc{int X1, int Y1, int X2, int Y2, int X3, int Y3, int X4, int Y4};
使用Arc过程，用当前画笔画一个椭圆形曲线。弧线横跨以点（x1, y1)和点(x2, y2)为边界的椭圆边。根据椭圆形周长，按照逆时针方向，从起始点至结束点画出弧线。起始点为椭圆中心和点（x3, y3)确定的直线与椭圆的交点。结束点为椭圆中心和点（x4, y4)确定的直线与椭圆的交点。注意：在Windows95中，x1+x2的和，以及y1+y2的和，不能超出32768。而且，x1+x2+y1+y2的和也不能超出32768。在Windows NT中，使用Windows API调用SetrcDirection方法，画弧线的方向可以改变为顺时针方向。
TCanvas::BrushCopy
复制位图的一部分到位于画布上的矩形中，并且用画布刷子的颜色替代图像的颜色。
void__fastcall BrushCopy(const Windows::TRect & Dest, TBitmap * Bitmap, const Windows::TRect & Source, Tcolor color);
使用BrushCopy可以获得诸如使复制图片部分透明这样的特殊效果。BrushCopy过程具有向后兼容性能。使用TImageList方法可以替代BrushCopy过程。为了使运用BrushCopy过程复制出来的图片具有部分透明效果，应当指定画布表面的颜色（如clBackground)作为Brush属性的Color参数，然后调用BrushCopy过程。
TCanvas::Chord
画一个由一条直线和一个椭圆相交，所构成的闭合图形。
void__fastcall Chord (int X1, int Y1, int X2, int Y2, int X3, int Y3, int X4, int Y4);
使用Chord可以创建一个由弧形及链接弧形两个端点的直线所构成 的图形。弦是椭圆以点（x1,y1)和点(x2,y2)为边界的一部分。椭圆被点（x3,y3)和点(x4,y4)之间的一条直线分割成两部分。
弦的边从点(x3,y3)开始，按逆时针方向沿椭圆运行到点（x4,y4),最后一直回到点(x3,y3).如果点(x3,y3)和点(x4,y4)，不在椭圆表面上，相应的弦的拐点，取在椭圆边上截断直线最接近的点。使用Pen属性数值可以画出弦的轮廓，使用Brush属性数值可以对图形进行填充。在Windows95中，x1+x2的和，以及y1+y2的和，不能超出32 768。而且，x1+x2+y1+y2的和也不能超出32 768。在Windows NT中，使用Windows API调用SetArcDirection方法，画弦的方向可以改变为顺时针方向。
TCanvas::CopyRect
将另一个画布上图形的一部分复制到这个画布上。
void__fastcall CopyRect (const Windows::TRect& Dest, TCanvas* Canvas, const Windows::TRect & Source);
使用CopyRect过程，可以将另一个画布上图形的一部分，转移到TCanvas对象的图片上。Dest参数，指定了将要复制的源图形存放在画布上的矩形区域。Canvas参数指定与源图像相关的画布。Source参数指定将要复制的源画布部分的矩形区域。源画布部分，通过使用CopyMode方法的指定模式来进行复制。
TCanvas::Draw
在给出的坐标（X，Y）位置处，Draw在画布上输出由Graphic参数指定的图像。
void __fastcall Draw(int X, int Y, TGraphic* Graphic);
调用Draw可以在画布上画出一个图像。Draw调用图形的Draw方法。图片输出到一个图形大小确定、左上角位于点（X，Y）处的矩形区域。
图像可以是点位图、图标或者图元文件。如果图像是一个Bitmap对象，点位图通过使用CopyMode方法的数值输出。
TCanvas::DrawFocusRect
画一个矩形框，通常用于表示矩形内的控件对象具有输入焦点。
void __fastcall DrawFocusRect( const Windows::TRect &Rect ) ;
当控件获得或失去输入焦点时，调用DrawFocusRect可以画出控件图片的边框。因为DrawFocusRect使用XOR功能，因此，当第二次调用drawFocusRect时，相同的矩形框将从屏幕上消失。
使用DrawFocusRect 画了出的矩形框，为能进行滚动。为了滚动由DrawFocusRect 画出的包含矩形框的区域，首先调用DrawFocusRect ，从屏幕上移去矩形框，滚动该区域，然后再调用drawFocusRect , 在新位置上画出矩形框。
TCamvas::Ellipse
在画布上的矩形范围内画椭圆。
void __fastcall Ellipse (int X1,int Y1,int X2,int Y2 );
调用Ellipse过程，可以在画布画圆或者椭圆。矩形范围的左上点位于像素坐标（x1,y1).矩形范围的右下点位于像素坐标 （x2,y2).。如果矩形窗体有所有点构成一个正方形，则将画出圆形。使用Pen属性的数值，可以画出椭圆轮廓；作用Brush属性的数值，可以对椭圆进行填充。
注意： 在Windows95中，x1 + x2 的和，以及 y1 +y2 的和，不能超出32768。而且，x1 +x2 +y1 +y2的和也不能超出32768。
TCanvas::fillRect
使用当前刷子填充画布上指定的矩形。
void__fastcall Rloodfill (int X, int Y ,TColor Color,TFillStyle FillStylr ) ;
使用Brush属性的数值，调用FloodFill 过程对可以一个非矩形区域进行填充，被填充区域的边界，从点（x,y,) 开始向外扩充，直到遇到Color参数指定的颜色边界为止。
FillStyle参数，确定了边界颜色变化类型，用下表进行表示。
数值 说明
fsSurface 填充所有由Color参数指定的颜色区域。当遇到另一种颜色时停止
fsBorder 填充所有由非Color参数指定的颜色区域。当遇到Color 参数指定的颜色边界时停止
当使用FillStyle参数为fsSurface的FloodFill过程时，使用Pixels属性可以获得位于点( x ,y )处的颜色的确切数值，类似地，当使用FillStyle参数为faBorder的FloodFill过程时，如果直到边界上的点，则使用Pixels属性可以获得边界颜色的确切数值。
TCanvas::FrameRect
使用画布的Brush属性，画出一个矩形的边框。
void__fastcall framsRect （ const Windows ::TRect &Rect ) ;
使用FrameRect可以画出一个像素宽的矩形区域有边界。FrameRect过程对矩形内部不用Brush属性进行填充。
通常，使用Polygon方法画一条边线，而不使用Pen方法 。
TCanvas ::LineTo
在画布上画开条从当前画笔位置到指定点（x,y)的直线，并且将画笔位置设置为点（x,y)。
void __fastcall LineTo (int X ,int Y)；
使用LineTo可以画一条从当前画笔位置到指定点（x,y)的直线，但不包括点 (x,y)。 LineTo 将画笔位置设置为点(x,y)。
TCanvas::Lock
可以使其他线条不在画布上画出。
void __ fastcall Lock(void );
在需要画多条线条的应用程序中，调用Lock过程可以使其他线条不在画布上画出。除非调用了UnLock方法，否则Lock过程可以使应用程序中的所有其他线条不会画出，嵌套调用Lock, 使LockCount属性增加，以致使画布上进行作图，除非最后一个锁定被释放。
由于Lock可以使所有其他线条不会画出，因此Lock对执行情况具有负影响，除非存在其他线条可能妨碍再画布上进行作图，则不要调用Lock 。
TCanvas::MoveTo
使用当前作图位置移到点（x,y).
void __ fastrall MoveTo ( int X , int Y ) ;
在调用LineTo之前，使用MoveTo可以对画笔位置数值进行设定。调用MoveTo的作用与设定画笔位置属性的作用相同。
