CDC
CDC类定义的是设备上下文对象的类。
CDC对象提供处理显示器或打印机等设备上下文的成员函数,以及处理与窗口客户区对应的显示上下文的成员。
通过CDC对象的成员函数进行所有的绘图。
类对设备上下文操作提供了成员函数,处理绘图工具。安全型图形设备接口(GDI)对象收集,以及处理颜色和调色板。
它还为获取和设置绘图属性、映射,处理视点、窗口扩展、转换坐标,处理区域、剪贴、绘制直线及绘制简单椭圆和多边形等形状提供了成员函数。
另外还为绘制文本、处理字体,使用打印机跳转,滚动和播放元文件提供成员函数。
使用CDC对象时要构造它,然后调用与它平等的、使用设备上下文的Windows函数的成员函数。
注意:
Windows 95下所有屏幕坐标限制在16位以内。因此向CDC成员函数传递的int必须在-32768至32767之间。
为了特定用途,Microsoft基本类库提供了几个CDC派生类。
CPaintDC |
包括BeginPaint和EndPaint调用。 |
CClientDC |
管理窗口用户区对应的显示上下文。 |
CWindowDC |
管理与整个窗口对应的显示上下文,包括它的结构和控件。 |
CMetaFileDC |
与带元文件的设备上下文对应。 |
CDC包含m_hDC和m_hAttribDC两个设备上下文,它们在CDC对象创建时参考同一个设备。
CDC指导所有对m_hDC的输出GDI调用以及对m_hAttribDC的大部分属性GDI调用(GetTextColor是属性调用的例子,而SetTextColor是一个输出调用)。
例如框架使用这两个设备上下文实现CMetaFileDC对象,在从物理设备读取属性期间向元文件发送输出。
打印预览以相同风格在框架中实现。还可以以相似方法在特殊应用代码中使用这两个设备上下文。
可能多次需要来自m_hDC和m_hAttribDC设备上下文的文本度量信息。
以下几对函数提供了这项功能:
使用m_hAttribDC |
使用m_hDC |
GetTextExtent |
GetOutputTextExtent |
GetTabbedTextExtent |
GetOutputTabbedTextExtent |
GetTextMetrics |
GetOutputTextMetrics |
GetCharWidth |
GetOutputCharWidth |
CDC类成员
数据成员
m_hDC |
CDC对象使用的输出设备上下文 |
m_hAttribDC |
CDC对象使用的输出属性上下文 |
构造函数
初始化
CreateDC |
为指定设备创建设备上下文 |
CreateIC |
为指定设备创建信息上下文。这提供了一种不创建设备上下文即获取有关设备信息的快速方式 |
CreateCompatibleDC |
创建内存设备上下文,与另一个设备上下文匹配。可以用它在内存中准备图像 |
DeleteDC |
删除CDC对象对应的Windows设备上下文 |
FromHandle |
给定设备上下文句柄时,返回指向CDC对象的指针。如果CDC对象未附加到句柄,则创建并附加一个临时CDC对象 |
DeleteTempMap |
由CWinApp空闲时间句柄调用,删除FromHandle创建的临时CDC对象。同时分离设备上下文 |
Attach |
把Windows设备上下文附加到这个CDC对象 |
Detach |
从CDC对象分离Windows设备上下文. |
SetAttribDC |
设置属性设备上下文m_hAttribDC |
SetOutputDC |
设置输出设备上下文m_hDC |
ReleaseAttribDC |
释放属性设备上下文m_hAttribDC |
ReleaseOutputDC |
释放输出设备上下文m_hDC |
GetCurrentBitmap |
返回指向当前选择的CBitmap对象的指针 |
GetCurrentBrush |
返回指向当前选择的CBrush对象的指针 |
GetCurrentFont |
返回指向当前选择的CFont对象的指针 |
GetCurrentPalette |
返回指向当前选择的CPalette对象的指针 |
GetCurrentPen |
返回指向当前选择的CPen对象的指针 |
GetWindow |
返回显示设备上下文对应的窗口 |
设备上下文函数
GetSafeHdc |
返回输出设备上下文m_hDC |
SaveDC |
保存设备上下文当前状态 |
RestoreDC |
恢复SaveDC保存的设备上下文以前状态 |
ResetDC |
更新m_hAttribDC设备上下文 |
GetDeviceCaps |
获取有关给定显示设备功能的指定类型指定设备信息 |
IsPrinting |
确定正在使用的设备上下文是否用于打印 |
安全型选择帮助器
GetBrushOrg |
获取当前画刷的起点 |
SetBrushOrg |
指定选入设备上下文的下一个画刷的起点 |
EnumObjects |
枚举设备上下文中有效的笔和画刷 |
颜色和颜色调色板函数
SelectObject |
选择笔等GDI绘图对象 |
SelectStockObject |
选择Windows提供的预定义的一个笔、画刷或字体 |
绘图工具函数
GetNearestColor |
获取与给定设备能显示的指定逻辑颜色最接近的逻辑色 |
SelectPalette |
选择逻辑调色板 |
RealizePalette |
把当前逻辑调色板中的调色板入口映射到系统调色板 |
UpdateColors |
通过客户区当前颜色在像素基础上与系统调色板的匹配,更新设备上下文的客户区 |
GetHalftoneBrush |
获取半色调画刷 |
绘图属性函数
GetBkColor |
获取当前背景色 |
SetBkColor |
设置当前背景色 |
GetBkMode |
获取背景模式 |
SetBkMode |
设置背景模式 |
GetPolyFillMode |
获取当前多边形填充模式 |
SetPolyFillMode |
设置多边形填充模式 |
GetROP2 |
获取当前绘图模式 |
SetROP2 |
设置当前绘图模式 |
GetStretchBltMode |
获取当前位图拉伸模式 |
SetStretchBltMode |
设置位图拉伸模式 |
GetTextColor |
获取当前文本颜色 |
SetTextColor |
设置文本颜色 |
GetColorAdjustment |
获取用于设备上下文的颜色调整值 |
SetColorAdjustment |
使用指定值设置设备上下文的颜色调整值 |
映射函数
GetMapMode |
获取当前映射模式 |
SetMapMode |
设置当前映射模式 |
GetViewportOrg |
获取视区起点的X和Y坐标 |
SetViewportOrg |
设置视区起点 |
OffsetViewportOrg |
相对于当前视区起点坐标修改视区起点 |
GetViewportExt |
获取视区X和Y范围 |
SetViewportExt |
设置视区X和Y范围 |
ScaleViewportExt |
相对于当前值修改视区范围 |
GetWindowOrg |
获取参应窗口起点的X和Y坐标 |
SetWindowOrg |
设置设备上下文的窗口起点 |
OffsetWindowOrg |
相对于当前窗口起点的坐标修改窗口起点 |
GetWindowExt |
获取对应窗口的X和Y坐标 |
SetWindowExt |
设置对应窗口的X和Y坐标 |
ScaleWindowExt |
相对于当前值修改窗口范围 |
坐标函数
DPtoHIMETRIC |
设备单位转换为HIMETRIC单位 |
LPtoHIMETRIC |
逻辑单位转换为HIMETRIC单位 |
DPtoLP |
设备单位转换为逻辑单位 |
LPtoDP |
逻辑单位转换为设备单位 |
HIMETRICtoDPHIMETRIC |
单位转换为设备单位 |
HIMETRICtoLPHIMETRIC |
单位转换为逻辑单位 |
区域函数
FillRgn |
用指定画刷填充指定区域 |
FrameRgn |
用画刷在指定区域周围绘制边线 |
InvertRgn |
反转区域中的颜色 |
PaintRgn |
用选取的画刷填充区域 |
剪切函数
SetBoundsRect |
控制指定设备上下文绑定的矩形信息的累计 |
GetBoundsRect |
返回到设备上下文当前累计的绑定矩形 |
GetClipBox |
获取当前剪切边界周围最紧绑定矩形的维数 |
SelectClipRgn |
使用指定模式合并给定区域和当前剪切区域 |
ExcludeClipRect |
创建包含现有剪切区域减掉指定矩形的一个新剪切区域 |
ExcludeUpdateRgn |
通过从剪切区域排除窗口中的更新区域,防止在窗口的无效区域中绘图 |
IntersectClipRect |
通过构成当前区域和矩形的交集创建一个新的剪切区域 |
OffsetClipRgn |
移动给定设备的剪切区域 |
PtVisible |
确定给定点是否在剪切区域内 |
RectVisible |
确定给定矩形的任何部分是否在剪切区域内 |
线输出函数
GetCurrentPosition |
获取笔的当前位置(以逻辑坐标表示) |
MoveTo |
移动当前位置 |
LineTo |
从当前位置到一点画直线,但不包括那个点 |
Arc |
画一段椭圆弧 |
ArcTo |
画一段椭圆弧。除了更新当前位置以外,这个函数与Arc类似 |
AngleArc |
画一条线段和圆弧,把当前位置移到圆弧终点 |
GetArcDirection |
对设备上下文返回当前圆弧方向 |
SetArcDirection |
设备圆弧和矩形函数要用到的绘图方向 |
PolyDraw |
画一组线段和Bezier样条。这个函数更新当前位置Polyline画一组与指定点连接的线段 |
PolyPolyline |
画多组相连线段。这个函数不使用也不更新当前位置 |
PolylineTo |
画一条或多条直线,并把当前位置移到最后一条直线的终点 |
PolyBezier |
画一条或多条Bezier样条。不使用也不更新当前位置 |
PolyBezierTo |
画一条或多条Bezier样条,并把当前位置移到最后一条Bezier样条的终点 |
简单绘图函数
FillRect |
用指定画刷填充给定矩形 |
FrameRect |
在矩形周围绘制边界 |
InvertRect |
反转矩形内容 |
DrawIcon |
绘制图标 |
DrawDragRect |
拖拽矩形时擦除并重绘它 |
FillSolidRect |
用实颜色填充矩形 |
Draw3Drect |
绘制三维矩形 |
DrawEdge |
绘制矩形边 |
DrawFrameControl |
绘制帧控件 |
DrawState |
显示图像并应用可视化效果来表示一个状态 |
椭圆和多边形函数
Chord |
绘制椭圆弧(椭圆和一条线段相交围成的闭合图形) |
DrawFocusRect |
绘制用于表示焦点的风格的矩形 |
Ellipse |
绘制椭圆 |
Pie |
绘制饼形图 |
Polygon |
绘制多边形,包含由线段连接的一个或多个点(顶点) |
PolyPolygon |
创建使用当前多边形填充模式的两个或多个多边形,多边形可以相互分开或叠加 |
Polyline |
绘制多边形,包含连接指定点的一组线段 |
Rectangle |
使用当前笔绘制矩形,用当前画刷填充 |
RoundRect |
使用当前笔绘制圆角矩形,用当前画刷填充 |
位图函数
PatBlt |
创建位特征 |
BitBlt |
从指定设备上下文拷贝位图 |
StretchBlt |
把位图由源矩形和设备移动到目标矩形,必要时拉伸或压缩位图以适合目标矩形的维数 |
GetPixel |
获取指定点像素的RGB颜色值 |
SetPixel |
设置指定点像素为最接近指定色的近似值 |
SetPixelV |
设置指定点坐标为最接近指定色的近似值。SetPixelV比SetPixel快,原因是它不用返回实际绘制点的颜色值 |
FloodFill |
用当前画刷填充区域 |
ExtFloodFill |
用当前画刷填充区域。比FloodFill成员函数提供更多灵活性 |
MaskBlt |
使用给定屏蔽和光栅操作对源和目标位图合并颜色数据 |
PlgBlt |
从源设备上下文的指定矩形到给定设备上下文中指定平行多边形,执行颜色数据位的位块传递 |
文本函数
TextOut |
用当前选取字体在指定位置写字符串 |
ExtTextOut |
用当前选取字体在矩形区域写字符串 |
TabbedTextOut |
在指定位置写字符串,制表符扩展为制表符停止位置数组中指定值 |
DrawText |
在指定矩形内绘制格式化文本 |
GetTextExtent |
使用当前字体在属性设备上下文上计算文本行的宽度和高度,确定维数 |
GetOutputTextExtent |
使用当前字体在输出设备上下文上计算文本行的宽度和高度,确定维数 |
GetTabbedTextExtent |
使用当前字体在属性设备上下文上计算字符串的宽度和高度 |
GetOutputTabbedTextExtent |
使用当前字体在输出设备上下文上计算字符串的宽度和高度 |
GrayString |
在给定位置绘制暗(灰色)文本 |
GetTextAlign |
获取文本对齐标记 |
SetTextAlign |
设置文本对齐标记 |
GetTextFace |
以空终止字符串形式把当前字体字样名拷贝到缓冲区 |
GetTextMetrics |
从属性设备上下文为当前字体获取度量 |
GetOutputTextMetrics |
从输出设备上下文为当前字体获取度量 |
SetTextJustification |
把空格添加到字符串的中断字符 |
GetTextCharacterExtra |
对字符间空格数量获取当前设置 |
SetTextCharacterExtra |
设置字符间空格数量 |
字体函数
GetFontData |
从比例字体文件获取字体度量信息。获取的信息通过指定字体文件与返回信息长度的偏移量标识 |
GetKerningPairs |
获取指定设备上下文中当前选取的字体字符实对 |
GetOutlineTextMetrics |
获取用于TrueType字体的字体度量信息 |
GetGlyphOutline |
获取用于当前字体中外线字符串的外线曲线或位图 |
GetCharABCWidths |
从当前字体获取给定范围相继字符以逻辑单位计数的宽度 |
GetCharWidth |
从当前字体获取给定范围相继字符的分数宽度 |
GetOutputCharWidth |
从使用输出设备上下文的当前字体获取相继字符组中各个字符的宽度 |
SetMapperFlags |
改变字体映射表在从逻辑字体到物理字符映射时使用的算法 |
GetAspectRatioFilter |
获取当前长宽比过滤器的设置 |
打印机跳离函数
QueryAbort |
对打印应用调用AbortPro回滚函数,询问打印是否应终止 |
Escape |
允许应用访问不能通过GDI直接使用的特殊设备的功能。同时允许访问Windows跳离函数。应用调用的Escape调用经翻译传送到设备驱动程序 |
DrawEscape |
访问通过图形设备接口(GDI)不能直接使用的视频显示器的绘图功能 |
StartDoc |
通告设备驱动程序开始一项新打印作业 |
StartPage |
通告设备驱动程序开始新页 |
EndPage |
通告设备驱动程序页结束 |
SetAbortProc |
如果打印作业必须终止,设置Windows调用的由程序员提供的回滚函数 |
AbortDoc |
终止当前打印任务,擦除自上次调用StartDoc成员函数以来应用写入设备的任何内容 |
EndDoc |
结束由StartDoc成员函数启动的打印作业 |
滚动函数
元文件函数
PlayMetaFile |
在给定设备上播放指定元文件类型。增强版本的PlayMetaFile显示以增强格式元文件保存的图片。元文件可以播放任意次数 |
AddMetaFileComment |
从缓冲区把注释拷贝到指定增强格式元文件 |
路径函数
AbortPath |
关闭并拒绝设备上下文中任何路径 |
BeginPath |
打开设备上下文中一个路径括号 |
CloseFigure |
关闭路径中一个打开的图表 |
EndPath |
关闭一个路径括号,并把括号定义的路径选择到设备上下文 |
FillPath |
关闭当前路径中任何打开的图表,并用当前画刷和多边形填充模式填充路径内部 |
FlattenPath |
变形选取到当前设备上下文路径中的任何曲线,把曲线变成一系列直线 |
GetMiterLimit |
返回用于设备上下文的限制 |
GetPath |
获取定义直线端点和从选择到设备上下文路径中找到的曲线控制点的坐标 |
SelectClipPath |
对设备上下文选择当前路径作为剪切区域,通过使用指定模式合并新区域和任何现有剪切区域 |
SetMiterLimit |
设备用于设备上下文的连接长度限制 |
StrokeAndFillPath |
关闭路径中任何打开的图表,使用当前笔点路径外线,使用当前画刷填充它内部 |
StrokePath |
使用当前笔描绘指定路径 |
WidenPath |
如果路径使用过了当前选取到设备上下文中的笔点,重新定义当前路径为要画的区域 |
* CClientDC子类
1. CClientDC类只能在客户区绘图;
2. 所谓客户区指窗口区域中去掉边框、标题栏、菜单栏、工具栏、状态栏等之外的部分,它是用户可以操作的区域;
3. 在使用CClientDC进行绘图时,一般要调用GetClientRect()函数来获取客户区域的大小;
4. CClientDC类在构造函数中调用Windows API函数GetDC(),在析构时响应ReleaseDC();
5. CClientDC类的窗口句柄保存在成员变量m_hWnd,为构造CClientDC,需将CWnd作为参数传递给构造函数。
* CWindowDC子类
1. CWindowDC对象在构造时调用Windows API函数GetWindowDC,在析构时调用相应的API函数ReleaseDC,这意味着CWindowDC对象可访问CWnd所指向的为整个全屏幕区域;
2. CWindowDC允许在显示器的任意位置绘图。坐标原点在整个窗口的左上角。
3. 在使用CWindowDC进行绘图时,一般要调用GetWindowRect函数来获取整个应用程序窗口区域的大小;
4. CWindowDC类的窗口句柄保存在成员变量m_hWnd,为构造CClientDC,需将CWnd作为参数传递给构造函数。
* CPaintDC子类
1. 通常CPaintDC用来响应WM_PAINT消息。一般应用在OnPaint函数.
2. CClientDC也是从CDC派生出来的.构造时自动调用GetDC函数,析构时自动调用ReleaseDC函数.一般应用于客户区窗口的绘制.
3. CPaintDC只能在WM_PAINT消息中使用, 用于有重画消息发出时才使用的内存设备环境, 而CClientDC和客户区相关,有重画消息发出时才使用的内存设备环境, 可在任何地方使用.
4. 在处理窗口重画时,必须使用CPaintDC,否则WM_PAINT消息无法从消息队列中清除,将引起不断的窗口重画。
* CMetaFileDC子类
1. 在应用程序中,有一些图像是需要经常重复显示的.这样的图形最好事先绘制好形成一个文件,并存储在内存中,当用到它时直接打开就可以了,这种图形文件叫做图元文件;
2. 制作图元文件需要一个特殊的设备描述环境CMetaFileDC类.它也是由CDC类继承来的,因此它包含了CDC类的所有绘图方法。
3. 一般先在视图类的OnCreate()函数中创建图元文件.具体做法为:先定义一个CMetaFileDC类的对象,然后用该对象的Create()函数创建它,该函数的原型为:BOOL Create(LPCTSTR lpszFilename=NULL);
4. 接下来使用由CDC继承来的绘图方法绘制图元文件,最后使用Close()函数结束绘制并保存该图元文件到类的数据成员中(该数据成员的类型应为HMETAFILE)。
5. 当需要显示该图元文件时,使用CDC类的成员函数PlayMetaFile()。当不再使用该图元文件时,要用函数DeleteMetaFile()将其删除。