必须调用GdiplusStartup初始化GDI+并保存token,否则创建Graphics会崩溃或返回NULL;需用GetDC+FromHDC获取Graphics,避免弃用构造函数;绘图资源如Pen、Font需手动管理,注意HDC释放和GdiplusShutdown配对。

初始化 GDI+ 时必须调用 GdiplusStartup 且保存 ULONG_PTR token
不调用 GdiplusStartup 就直接创建 Graphics 或绘图,程序会崩溃或返回 NULL。GDI+ 不是 Windows 自带即用的模块,它需要显式初始化并持有生命周期句柄。
- 全局或类静态变量中声明
ULONG_PTR gdiplusToken,避免函数内局部存储后被销毁 -
GdiplusStartupInput的NotificationCallback字段通常设为nullptr,除非你真要监听通知 - 必须在
WinMain或main(GUI 子系统)开头调用,且在PostQuitMessage后、程序退出前调用GdiplusShutdown(gdiplusToken)
ULONG_PTR gdiplusToken; GdiplusStartupInput gdiplusStartupInput; GdiplusStartup(&gdiplusToken, &gdiplusStartupInput, nullptr);
获取图形上下文要用 GetDC + Graphics::FromHDC,别直接传窗口句柄
Graphics 对象不能靠 Graphics(hwnd) 构造——这个构造函数已被弃用且在 Windows 10+ 上返回 NULL。正确路径是先取设备上下文,再“升格”为 GDI+ 上下文。
- 在
WM_PAINT中:用BeginPaint获取HDC,完成后必须EndPaint - 在非重绘场景(如响应鼠标点击后立刻刷新):用
GetDC(hwnd),绘制完立即ReleaseDC(hwnd, hdc) - 务必检查
Graphics::FromHDC返回值是否为nullptr,常见于 HDC 无效或 GDI+ 未初始化
HDC hdc = GetDC(hwnd);
if (hdc) {
Graphics* g = Graphics::FromHDC(hdc);
if (g) {
// 绘图操作
delete g;
}
ReleaseDC(hwnd, hdc);
}画线/矩形/椭圆等基本图形,注意坐标系原点和笔刷对象生命周期
GDI+ 默认坐标系原点在左上角,x 向右递增,y 向下递增,与 Win32 GDI 一致。但所有绘图函数(如 DrawLine)都依赖 Pen 和 SolidBrush 等资源对象——它们不是轻量值类型,而是需手动管理的堆对象。
-
Pen构造时传入颜色和线宽,线宽为1.0f表示 1 像素;小于 1 可能被忽略或触发抗锯齿行为 - 不要在循环里反复 new/delete
Pen;应复用或封装为成员变量 -
DrawRectangle参数是(x, y, width, height),不是左上/右下坐标;FillEllipse同理,是外接矩形参数 - 若开启抗锯齿(
g->SetSmoothingMode(SmoothingModeAntiAlias)),文本和曲线更平滑,但直线边缘可能发虚,慎用于 UI 控件边框
Pen pen(Color(255, 0, 0, 255), 2.0f); // 红色,2像素宽 g->DrawLine(&pen, 10, 10, 100, 100); g->DrawRectangle(&pen, 50, 50, 120, 80);
文字渲染要用 DrawString,但字体对象必须显式构造且注意字符编码
Graphics::DrawString 不接受 C 风格字符串字面量直接传参,也不自动识别 UTF-8。Windows API 层面默认使用 UTF-16,所以必须确保传入的是 LPCWSTR(即 wchar_t*)。
立即学习“C++免费学习笔记(深入)”;
- 中文字符串要加
L前缀:L"你好",或用MultiByteToWideChar转换 UTF-8 字符串 -
Font对象需指定字体名、大小(单位是逻辑像素,非物理像素)、样式(如FontStyleBold) -
RectF指定文本布局区域,StringFormat控制对齐方式;不设置时默认左上对齐,超出区域会被裁剪 - 字体对象建议缓存,频繁创建销毁影响性能,尤其在
WM_PAINT中
Font font(L"Microsoft YaHei", 14.0f); RectF layout(10.0f, 100.0f, 200.0f, 50.0f); StringFormat format; format.SetAlignment(StringAlignmentCenter); g->DrawString(L"Hello 世界", -1, &font, layout, &format, &brush);
GDI+ 的图形上下文不是“即开即用”的抽象层,它每一层(启动、HDC 绑定、Pen/Font 创建)都对应真实资源分配。最容易出问题的地方不在画错了什么,而是在某处忘了 delete、ReleaseDC 或 GdiplusShutdown,导致句柄泄漏或后续绘图静默失败。











