MFC：CDC 类与成员
CDC
定义
-
设备上下文对象类；
-
使用成员函数可以进行所有的绘图操作；
作用
-
获取和设置绘图属性、映射，处理视点、窗口扩展、转换坐标，处理区域、剪贴、绘制直线及绘制简单椭圆和多边形等形状；
-
安全型图形设备接口（GDI）对象收集，以及处理颜色和调色板；
-
绘制文本、处理字体，使用打印机跳转，滚动和播放元文件；
成员
-
处理显示器或打印机等设备上下文的成员函数；
-
处理与窗口客户区关联的显示上下文的成员函数；
-
两个设备上下文：m_hDC、m_hAttribDC，它们在 CDC 对象创建时参考同一设备；
-
m_hDC：CDC 对象使用的输出设备上下文；
-
m_hAttribDC：CDC 对象使用的输出属性上下文；
-
CPaintDC
-
CPaintDC 类 | Microsoft Learn
-
仅为响应 Windows 消息 WM_PAINT 的成员函数提供设备环境，完成客户区绘图操作；
-
在构造时执行 CWnd::BeginPaint，在销毁时执行 CWnd::EndPaint；
/// 在需要绘图的地方添加消息响应函数。
/// 声明CPaintDC对象。
/// 调用BeginPaint函数获取设备上下文。
/// 进行绘图操作。
/// 调用EndPaint函数释放设备上下文。
void CMFCDrawingView::OnPaint()
{
CPaintDC dc(this);
// 绘制椭圆
dc.Ellipse(100, 100, 200, 200);
// 释放设备上下文
dc.EndPaint();
}PAINTSTRUCT
-
用于绘制应用程序拥有的窗口的工作区；
typedef struct tagPAINTSTRUCT {
HDC hdc; // 于绘制的显示 DC 的句柄
BOOL fErase; // 是否必须擦除背景
RECT rcPaint; // 指定请求绘制的矩形的左上角和右下角
BOOL fRestore;
BOOL fIncUpdate;
BYTE rgbReserved[32];
} PAINTSTRUCT, *PPAINTSTRUCT, *NPPAINTSTRUCT, *LPPAINTSTRUCT;CClientDC
-
CClientDC 类 | Microsoft Learn
-
为非响应 Windows 消息 WM_PAINT 的成员函数提供设备环境，完成客户区临时绘图；
-
管理窗口用户区对应的显示上下文；
-
处理 Windows 函数 GetDC（在构造时）和 ReleaseDC（在析构时）的调用
void CMFC绘图View::OnHuahua() // 在客户区的（100，100）位置输出字符串
{
// 创建对象，在视图对象里画
CClientDC dc(this);
dc.TextOutA(100,100, " aiyou");
//::TextOut(dc.m_hDC, 100, 100, " hello client", strlen(" aiyou"));
}CWindowDC
-
管理与整个窗口（包括客户区和非客户区）对应的上下文，包括它的结构和控件；
-
不同于前文的两个类，它可用于绘制窗口的非客户区，如标题栏、边框等；
void CMFCDrawingView::OnNcPaint() // 响应WM_NCPAINT消息
{
CWindowDC dc(this);
// 在非客户区绘制一段文本
dc.DrawText("Non-Client Area", &dc, CPoint(10, 10));
// 释放设备上下文
dc.ReleaseDC();
}CMetaFileDC
-
与带元文件的设备上下文对应；
初始化
| 函数名 | 描述 |
|---|---|
| CreateDC | 为指定设备创建设备上下文 |
| CreateIC | 信息上下文，一种不创建设备上下文即获取有关设备信息的快速方式 |
| CreateCompatibleDC | 创建内存设备上下文，与另一个设备上下文匹配。可以用它在内存中准备图像 |
| DeleteDC | 删除CDC对象对应的Windows设备上下文 |
| FromHandle | 给定设备上下文句柄时，返回指向CDC对象的指针。如果CDC对象未附加到句柄，则创建并附加一个临时CDC对象 |
| DeleteTempMap | 由CWinApp空闲时间句柄调用，删除FromHandle创建的临时CDC对象。同时分离设备上下文 |
| Attach | 把 Windows 设备上下文附加到 CDC 对象 |
| Detach | 对象分离 |
| SetAttribDC | 设置属性设备上下文 m_hAttribDC |
| SetOutputDC | 输出设备上下文 m_hDC |
| ReleaseAttribDC | 释放 |
| ReleaseOutputDC | 释放 |
| GetCurrentBitmap | 返回指向当前选择的 CBitmap 对象的指针 |
| GetCurrentBrush | CBrush |
| GetCurrentFont | CFont |
| GetCurrentPalette | CPalette |
| GetCurrentPen | CPen |
| GetWindow | 返回显示设备上下文对应的窗口 |
设备上下文
| 函数名 | 描述 |
|---|---|
| GetSafeHdc | 返回输出设备上下文 m_hDC |
| SaveDC | 保存设备上下文当前状态 |
| RestoreDC | 恢复SaveDC保存的 |
| ResetDC | 更新 m_hAttribDC 设备上下文 |
| GetDeviceCaps | 获取有关给定显示设备功能的指定类型指定设备信息 |
| IsPrinting | 确定正在使用的设备上下文是否用于打印 |
颜色和调色板
| 函数名 | 描述 |
|---|---|
| SelectObject | 选择笔等GDI绘图对象 |
| SelectStockObject | 选择Windows提供的预定义的一个笔、画刷或字体 |
绘图
绘图工具
| 函数名 | 描述 |
|---|---|
| GetNearestColor | 获取与给定设备能显示的指定逻辑颜色最接近的逻辑色 |
| SelectPalette | 选择逻辑调色板 |
| RealizePalette | 把当前逻辑调色板中的调色板入口映射到系统调色板 |
| UpdateColors | 通过客户区当前颜色在像素基础上与系统调色板的匹配，更新设备上下文的客户区 |
| GetHalftoneBrush | 取半色调画刷 |
绘图属性
| GetBkColor | 获取当前背景色 |
|---|---|
| SetBkColor | |
| GetBkMode | 背景模式 |
| SetBkMode | |
| GetPolyFillMode | 当前多边形填充模式 |
| SetPolyFillMode | |
| GetROP2 | 当前绘图模式 |
| SetROP2 | |
| GetStretchBltMode | 当前位图拉伸模式 |
| SetStretchBltMode | |
| GetTextColor | 当前文本颜色 |
| SetTextColor | |
| GetColorAdjustment | 用于设备上下文的颜色调整值 |
| SetColorAdjustment |
绘制
| FillRect | 用指定画刷填充给定矩形 |
|---|---|
| FrameRect | 矩形周围绘制边界 |
| InvertRect | 反转矩形内容 |
| DrawIcon | 图标 |
| DrawDragRect | 拖拽矩形时擦除并重绘 |
| FillSolidRect | 用实颜色填充矩形 |
| Draw3Drect | 三维矩形 |
| DrawEdge | 矩形边 |
| DrawFrameControl | 帧控件 |
| DrawState | 显示图像并应用可视化效果来表示一个状态 |
坐标
映射
| GetMapMode | 当前映射模式 |
|---|---|
| SetMapMode | |
| GetViewportOrg | 获取视区起点的 X 和 Y 坐标 |
| SetViewportOrg | |
| OffsetViewportOrg | 相对于当前视区起点坐标修改视区起点 |
| GetViewportExt | 视区 X 和 Y 范围 |
| SetViewportExt | |
| ScaleViewportExt | 相对于当前值修改视区范围 |
| GetWindowOrg | 窗口起点的X和Y坐标 |
| SetWindowOrg | |
| OffsetWindowOrg | 相对于当前窗口起点的坐标修改窗口起点 |
| GetWindowExt | 对应窗口的X和Y坐标 |
| SetWindowExt | |
| ScaleWindowExt | 相对于当前值修改窗口范围 |
单位转换
| DPtoHIMETRIC | 设备单位转换为 HIMETRIC 单位 |
|---|---|
| LPtoHIMETRIC | 逻辑单位转换 |
| DPtoLP | |
| LPtoDP | |
| HIMETRICtoDPHIMETRIC | 单位转换为设备单位 |
| HIMETRICtoLPHIMETRIC | 转换为逻辑单位 |
区域
区域属性
| FillRgn | 用指定画刷填充指定区域 |
|---|---|
| FrameRgn | 用画刷在指定区域周围绘制边线 |
| InvertRgn | 反转区域中的颜色 |
| PaintRgn | 用选取的画刷填充区域 |
剪切
| SetBoundsRect | 控制指定设备上下文绑定的矩形信息的累计 |
|---|---|
| GetBoundsRect | |
| GetClipBox | 获取当前剪切边界周围最紧绑定矩形的维数 |
| SelectClipRgn | 使用指定模式合并给定区域和当前剪切区域 |
| ExcludeClipRect | 创建包含现有剪切区域减掉指定矩形的一个新剪切区域 |
| ExcludeUpdateRgn | 通过从剪切区域排除窗口中的更新区域，防止在窗口的无效区域中绘图 |
| IntersectClipRect | 通过构成当前区域和矩形的交集创建一个新的剪切区域 |
| OffsetClipRgn | 移动给定设备的剪切区域 |
| PtVisible | 确定给定点是否在剪切区域内 |
| RectVisible | 确定给定矩形的任何部分是否在剪切区域内 |
线
| GetCurrentPosition | 获取笔的当前位置（以逻辑坐标表示） |
|---|---|
| MoveTo | 移动当前位置 |
| LineTo | 从当前位置到一点画直线，但不包括那个点 |
| Arc | 画一段椭圆弧 |
| ArcTo | 除了更新当前位置以外 |
| AngleArc | 画一条线段和圆弧，把当前位置移到圆弧终点 |
| GetArcDirection | 返回当前圆弧方向 |
| SetArcDirection | 设备圆弧和矩形函数要用到的绘图方向 |
| PolyDraw | 画一组线段和Bezier样条。这个函数更新当前位置Polyline画一组与指定点连接的线段 |
| PolyPolyline | 画多组相连线段。这个函数不使用也不更新当前位置 |
| PolylineTo | 画一条或多条直线，并把当前位置移到最后一条直线的终点 |
| PolyBezier | 画一条或多条Bezier样条。不使用也不更新当前位置 |
| PolyBezierTo | 并把当前位置移到最后一条Bezier样条的终点 |
文本
| TextOut | 用当前选取字体在指定位置写字符串 |
|---|---|
| ExtTextOut | 矩形区域写字符串 |
| TabbedTextOut | 指定位置写字符串，制表符扩展为制表符停止位置数组中指定值 |
| DrawText | 定矩形内绘制格式化文本 |
| GetTextExtent | 使用当前字体在属性设备上下文上计算文本行的宽度和高度，确定维数 |
| GetOutputTextExtent | 在输出设备上下文上计算 |
| GetTabbedTextExtent | 在属性设备上下文上计算字符串的宽度和高度 |
| GetOutputTabbedTextExtent | 在输出设备上下文上计算字符串的宽度和高度 |
| GrayString | 给定位置绘制暗（灰色）文本 |
| GetTextAlign | 文本对齐标记 |
| SetTextAlign | |
| GetTextFace | 以空终止字符串形式把当前字体字样名拷贝到缓冲区 |
| GetTextMetrics | 从属性设备上下文为当前字体获取度量 |
| GetOutputTextMetrics | 输出设备上下文 |
| SetTextJustification | 把空格添加到字符串的中断字符 |
| GetTextCharacterExtra | 获取当前字符的额外间距（空格），以像素为单位 |
| SetTextCharacterExtra |