MFC自绘控件实战：CStaticEx扩展CStatic实现渐变背景与悬停交互-育师

简介：CStaticEx扩展静态文本框是一份面向MFC界面开发者的轻量级控件源码，针对原生CStatic功能单一、难以满足美化需求的问题，提供背景透明、文字颜色与字体样式设置、内容动态修改、链接与手型光标、Flash闪烁文字等六项扩展能力，适合具备一定MFC基础、希望在对话框或视图界面中快速实现个性化文本展示的开发者参考使用。资源包共2个文件，包含1个h头文件与1个cpp实现文件，分别用于接口声明与功能实现，压缩包整体约3KB，体量小巧，便于直接集成到现有工程中。目前已有568人学习下载，说明该控件在MFC界面美化场景中具有一定实用价值。读者可从中获得一套可直接编译复用的扩展静态文本框实现，理解透明背景绘制、字体属性设置、定时器驱动颜色切换以及鼠标悬停交互等关键处理思路，尤其能解决设置透明背景后修改文字出现重影的常见问题，为自绘控件开发提供可借鉴的代码范例。

1. 从 CStatic 到 CStaticEx：一个被低估的 MFC 扩展控件

做 MFC 界面开发的人，早晚会碰到 CStatic 的天花板。标准 CStatic 能显示文本、图标、位图、矩形框，但一旦需求变成"文字要竖排""背景要渐变""鼠标悬停要变色""点击要响应"，原生控件立刻不够用。常见的做法是自绘整个对话框，或者干脆换 Qt，但老项目动不了框架，只能想办法在 CStatic 上做扩展。CStaticEx 就是在这个场景下出现的——它不是微软官方控件，而是一类对 CStatic 做派生扩展的实现方案，核心思路是接管 WM_PAINT 和若干鼠标消息，把绘制权从系统手里拿回来。

这份资源适合两类人：一是维护遗留 MFC 项目、需要在不动框架的前提下增强静态文本表现力的工程师；二是正在学 MFC 自绘机制、想找一个比按钮自绘更简单的切入点的新手。它解决的不是"能不能显示文字"的问题，而是"文字怎么显示、怎么交互、怎么在不同 DPI 下不糊"的问题。下面按实际拆解的顺序，从原理到代码到踩坑，一步步说清楚。

2. CStaticEx 的绘制原理与消息接管机制

2.1 为什么必须接管 WM_PAINT

标准 CStatic 的绘制完全由系统完成，父窗口收到 WM_CTLCOLORSTATIC 后返回一个画刷，系统用这个画刷填背景、用默认字体画文字。整个过程你只能控制颜色和字体，控制不了绘制顺序、透明效果、文字排版。CStaticEx 的第一步就是让控件自己处理 WM_PAINT，在 OnPaint 里创建内存 DC，先画背景（可以是纯色、渐变、位图），再画文字（可以带阴影、描边、竖排），最后 BitBlt 到屏幕 DC。

这里有个关键点：如果只是简单重写 OnPaint 而不设置控件样式，系统仍然会在绘制前用背景刷擦除客户区，导致闪烁。常见做法是在 PreSubclassWindow 或 OnCreate 里去掉 SS_SIMPLE 之外的默认样式，或者直接调用 ModifyStyle 把 SS_OWNERDRAW 加上，让系统知道这个控件要自绘。

void CStaticEx::PreSubclassWindow() { // 去掉系统默认的静态样式，改为自绘 ModifyStyle(SS_TYPEMASK, SS_OWNERDRAW); CStatic::PreSubclassWindow(); }

ModifyStyle 的第一个参数是要移除的位，SS_TYPEMASK 覆盖了所有静态控件类型位；第二个参数 SS_OWNERDRAW 告诉系统这个控件由父窗口或自身负责绘制。这一步不做，后面 OnPaint 里画的东西会被系统覆盖。

2.2 内存 DC 与双缓冲的落地写法

闪烁是自绘控件的头号敌人。CStaticEx 里标准的双缓冲写法是：在 OnPaint 里用 CPaintDC 获取屏幕 DC，然后 CreateCompatibleDC 创建内存 DC，CreateCompatibleBitmap 创建兼容位图，选入内存 DC 后所有绘制操作都在内存里完成，最后一次性 BitBlt 到屏幕。

void CStaticEx::OnPaint() { CPaintDC dc(this); CRect rect; GetClientRect(&rect); // 创建内存 DC 和兼容位图 CDC memDC; memDC.CreateCompatibleDC(&dc); CBitmap bmp; bmp.CreateCompatibleBitmap(&dc, rect.Width(), rect.Height()); CBitmap* pOldBmp = memDC.SelectObject(&bmp); // 在内存 DC 上绘制背景和文字 DrawBackground(&memDC, rect); DrawText(&memDC, rect); // 一次性拷贝到屏幕 dc.BitBlt(0, 0, rect.Width(), rect.Height(), &memDC, 0, 0, SRCCOPY); memDC.SelectObject(pOldBmp); }

DrawBackground 和 DrawText 是两个虚函数，派生类可以重写。DrawBackground 里根据 m_bkMode 决定是填充纯色、画渐变还是贴位图；DrawText 里根据 m_textAlign、m_bVertical 等成员变量决定文字对齐方式和排列方向。参数说明：m_bkMode 一般定义成枚举，取值 BK_SOLID、BK_GRADIENT、BK_BITMAP；m_textAlign 用 DT_LEFT、DT_CENTER、DT_RIGHT 等标准值。

2.3 鼠标消息与交互状态管理

CStatic 默认不接收鼠标消息，因为它的窗口过程对 WM_MOUSEMOVE、WM_LBUTTONDOWN 等消息直接返回 0。要让 CStaticEx 响应悬停和点击，必须在 PreSubclassWindow 里设置 SS_NOTIFY 样式，或者在消息映射里手动添加 ON_WM_MOUSEMOVE、ON_WM_LBUTTONDOWN。

BEGIN_MESSAGE_MAP(CStaticEx, CStatic) ON_WM_PAINT() ON_WM_MOUSEMOVE() ON_WM_MOUSELEAVE() ON_WM_LBUTTONDOWN() ON_WM_LBUTTONUP() END_MESSAGE_MAP()

ON_WM_MOUSELEAVE 不是标准消息映射宏，需要自己用 TrackMouseEvent 实现。在 OnMouseMove 里第一次进入时调用 TrackMouseEvent 注册离开通知，然后在 OnMouseLeave 里把悬停状态置为 false 并重绘。悬停状态用一个 bool 成员 m_bHover 记录，OnPaint 里根据这个值切换文字颜色或背景色。

注意：TrackMouseEvent 注册后只生效一次，每次 OnMouseMove 里都要重新注册，否则鼠标离开后不会收到 WM_MOUSELEAVE。

3. 从零实现一个可用的 CStaticEx 类

3.1 类声明与成员变量设计

一个能用的 CStaticEx 类，成员变量要覆盖背景、文字、边框、交互四个维度。下面是一个精简但完整的声明：

class CStaticEx : public CStatic { DECLARE_DYNAMIC(CStaticEx) public: CStaticEx(); virtual ~CStaticEx(); // 背景设置 void SetBkColor(COLORREF clr) { m_clrBk = clr; Invalidate(); } void SetBkGradient(COLORREF clr1, COLORREF clr2, BOOL bVertical = TRUE); void SetBkBitmap(UINT nID) { m_nBkBitmapID = nID; Invalidate(); } // 文字设置 void SetTextColor(COLORREF clr) { m_clrText = clr; Invalidate(); } void SetHoverTextColor(COLORREF clr) { m_clrHoverText = clr; Invalidate(); } void SetVertical(BOOL bVertical) { m_bVertical = bVertical; Invalidate(); } // 边框设置 void SetBorder(BOOL bBorder, COLORREF clrBorder = RGB(0,0,0)); protected: COLORREF m_clrBk; COLORREF m_clrBk2; BOOL m_bGradient; BOOL m_bGradientVertical; UINT m_nBkBitmapID; COLORREF m_clrText; COLORREF m_clrHoverText; COLORREF m_clrBorder; BOOL m_bBorder; BOOL m_bVertical; BOOL m_bHover; BOOL m_bTracking; virtual void DrawBackground(CDC* pDC, CRect& rect); virtual void DrawText(CDC* pDC, CRect& rect); virtual void DrawBorder(CDC* pDC, CRect& rect); afx_msg void OnPaint(); afx_msg void OnMouseMove(UINT nFlags, CPoint point); afx_msg void OnMouseLeave(); afx_msg void OnLButtonDown(UINT nFlags, CPoint point); DECLARE_MESSAGE_MAP() };

每个 Set 函数末尾都调用 Invalidate()，触发重绘。这是自绘控件的基本纪律：属性变了不重绘，界面就不会更新。m_bTracking 用来标记是否已经注册了 TrackMouseEvent，避免重复注册。

3.2 渐变背景与竖排文字的实现

渐变背景用 GradientFill 或者手动逐行画线。GradientFill 是 Windows XP 以后提供的 API，需要链接 msimg32.lib。竖排文字没有现成 API，只能逐字计算位置。

void CStaticEx::DrawBackground(CDC* pDC, CRect& rect) { if (m_nBkBitmapID != 0) { // 位图背景：从资源加载并拉伸 CBitmap bmp; bmp.LoadBitmap(m_nBkBitmapID); CDC memDC; memDC.CreateCompatibleDC(pDC); CBitmap* pOld = memDC.SelectObject(&bmp); BITMAP bm; bmp.GetBitmap(&bm); pDC->StretchBlt(rect.left, rect.top, rect.Width(), rect.Height(), &memDC, 0, 0, bm.bmWidth, bm.bmHeight, SRCCOPY); memDC.SelectObject(pOld); } else if (m_bGradient) { TRIVERTEX vert[2]; vert[0].x = rect.left; vert[0].y = rect.top; vert[0].Red = GetRValue(m_clrBk) << 8; vert[0].Green = GetGValue(m_clrBk) << 8; vert[0].Blue = GetBValue(m_clrBk) << 8; vert[0].Alpha = 0; vert[1].x = rect.right; vert[1].y = rect.bottom; vert[1].Red = GetRValue(m_clrBk2) << 8; vert[1].Green = GetGValue(m_clrBk2) << 8; vert[1].Blue = GetBValue(m_clrBk2) << 8; vert[1].Alpha = 0; GRADIENT_RECT gr = {0, 1}; ::GradientFill(pDC->GetSafeHdc(), vert, 2, &gr, 1, m_bGradientVertical ? GRADIENT_FILL_RECT_V : GRADIENT_FILL_RECT_H); } else { pDC->FillSolidRect(rect, m_clrBk); } }

TRIVERTEX 里的颜色值要左移 8 位，因为 GradientFill 用的是 16 位色分量。GRADIENT_FILL_RECT_V 表示垂直渐变，GRADIENT_FILL_RECT_H 表示水平渐变。竖排文字的实现思路是：取字符串每个字符，用 GetTextExtent 算宽高，然后逐字往下画，每个字符的 x 坐标居中。

void CStaticEx::DrawText(CDC* pDC, CRect& rect) { CString strText; GetWindowText(strText); pDC->SetBkMode(TRANSPARENT); pDC->SetTextColor(m_bHover ? m_clrHoverText : m_clrText); if (!m_bVertical) { pDC->DrawText(strText, rect, DT_CENTER | DT_VCENTER | DT_SINGLELINE); return; } // 竖排：逐字绘制 int nLen = strText.GetLength(); int nTotalHeight = 0; CSize szChar; for (int i = 0; i < nLen; i++) { szChar = pDC->GetTextExtent(strText.Mid(i, 1)); nTotalHeight += szChar.cy; } int y = rect.top + (rect.Height() - nTotalHeight) / 2; for (int i = 0; i < nLen; i++) { CString strChar = strText.Mid(i, 1); szChar = pDC->GetTextExtent(strChar); int x = rect.left + (rect.Width() - szChar.cx) / 2; pDC->TextOut(x, y, strChar); y += szChar.cy; } }

GetTextExtent 返回的 CSize 里 cx 是字符宽度，cy 是字符高度。竖排时每个字符的 x 坐标按控件宽度居中，y 坐标累加。这个写法对英文和数字也适用，但英文竖排看起来会有点怪，实际项目里一般只对中文用竖排。

3.3 悬停与点击的完整消息处理

悬停效果依赖 TrackMouseEvent，点击效果依赖 WM_LBUTTONDOWN 和 WM_LBUTTONUP 的状态切换。

void CStaticEx::OnMouseMove(UINT nFlags, CPoint point) { if (!m_bTracking) { TRACKMOUSEEVENT tme; tme.cbSize = sizeof(tme); tme.dwFlags = TME_LEAVE; tme.hwndTrack = m_hWnd; tme.dwHoverTime = 0; _TrackMouseEvent(&tme); m_bTracking = TRUE; } if (!m_bHover) { m_bHover = TRUE; Invalidate(); } CStatic::OnMouseMove(nFlags, point); } void CStaticEx::OnMouseLeave() { m_bTracking = FALSE; m_bHover = FALSE; Invalidate(); CStatic::OnMouseLeave(); }

_TrackMouseEvent 是 TrackMouseEvent 的封装，TME_LEAVE 表示鼠标离开客户区时发送 WM_MOUSELEAVE。m_bHover 变化时调用 Invalidate 触发重绘，OnPaint 里根据 m_bHover 切换文字颜色。点击响应一般是在 OnLButtonDown 里发一个通知消息给父窗口，或者直接调用一个回调函数。

注意：如果控件在对话框上，OnMouseLeave 可能不会触发，因为对话框本身会捕获鼠标。解决办法是在 OnMouseMove 里判断 point 是否还在客户区，不在就手动置 m_bHover = FALSE。

4. 避坑与常见问题排查

4.1 控件不刷新或刷新后文字消失

现象：调用 SetTextColor 后界面没变化，或者重绘后文字不见了。原因通常是 Invalidate 调用了但没触发 OnPaint，或者 OnPaint 里没调用 CStatic::OnPaint 导致系统绘制被跳过。解决：确认 Invalidate(TRUE) 参数为 TRUE 表示擦除背景；如果父窗口有 WS_CLIPCHILDREN 样式，子控件重绘不受影响，但父窗口重绘时不会擦除子控件区域，这时需要手动在 OnPaint 里填背景。

4.2 背景透明时出现黑块

现象：设置背景透明后，文字周围出现黑色矩形。原因是内存 DC 创建时没有设置背景模式，或者 BitBlt 时用了 SRCCOPY 把内存 DC 的黑色背景也拷过去了。解决：在内存 DC 里先用 FillSolidRect 填成父窗口背景色，或者用 TransparentBlt 代替 BitBlt。更彻底的做法是在 OnCtlColor 里返回 NULL_BRUSH，让系统不擦除背景。

4.3 高 DPI 下文字模糊或错位

现象：在 125% 或 150% 缩放下，文字发虚，竖排文字间距不对。原因是 MFC 默认按 96 DPI 计算字体和坐标，高 DPI 下需要手动缩放。解决：在 OnPaint 里用 GetDpiForWindow 获取当前 DPI，然后按 dpi/96.0 的比例缩放字体高度和坐标。或者直接在清单文件里声明 DPI 感知，让系统自动缩放。

4.4 动态创建时 PreSubclassWindow 不执行

现象：用 Create 动态创建 CStaticEx 后，自绘样式没生效。原因是 PreSubclassWindow 只在子类化已有控件时调用，动态创建走的是 OnCreate。解决：把样式设置代码同时放到 OnCreate 和 PreSubclassWindow 里，或者重写 Create 函数在创建后手动调用 ModifyStyle。

4.5 多个 CStaticEx 同时刷新导致闪烁

现象：对话框上放了五六个 CStaticEx，鼠标划过时整个对话框闪。原因是每个控件独立重绘，父窗口背景被反复擦除。解决：给对话框加上 WS_CLIPCHILDREN 样式，或者在父窗口的 OnEraseBkgnd 里直接返回 TRUE 阻止背景擦除。更稳妥的做法是用双缓冲对话框，把所有控件的绘制统一到一次 BitBlt 里。

5. 进阶技巧：把 CStaticEx 做成可复用的控件库

5.1 用 DECLARE_DYNAMIC 支持运行时类型识别

如果打算把 CStaticEx 放到一个独立的静态库或 DLL 里给多个项目用，DECLARE_DYNAMIC 和 IMPLEMENT_DYNAMIC 是必须的。它们让控件支持 RUNTIME_CLASS 和 IsKindOf，方便在对话框里动态替换控件类型。

// 头文件 DECLARE_DYNAMIC(CStaticEx) // 实现文件 IMPLEMENT_DYNAMIC(CStaticEx, CStatic)

没有这两个宏，CWnd::GetRuntimeClass 返回的是 CStatic，动态创建时会实例化错类。加上之后，可以用RUNTIME_CLASS(CStaticEx)做类型判断，也可以在对话框的 DoDataExchange 里用 DDX_Control 绑定。

5.2 属性持久化与设计期支持

如果希望控件在对话框编辑器里能拖放、能通过属性面板改颜色，需要实现属性页和持久化。MFC 的做法是重写 DoPropExchange，把成员变量和属性包绑定。

void CStaticEx::DoPropExchange(CPropExchange* pPX) { CStatic::DoPropExchange(pPX); PX_Color(pPX, _T("BkColor"), m_clrBk, RGB(255,255,255)); PX_Color(pPX, _T("TextColor"), m_clrText, RGB(0,0,0)); PX_Bool(pPX, _T("Vertical"), m_bVertical, FALSE); PX_Bool(pPX, _T("Gradient"), m_bGradient, FALSE); }

PX_Color 和 PX_Bool 是 MFC 提供的属性交换函数，第三个参数是变量，第四个是默认值。这样在对话框资源里保存后，下次打开属性不会丢。设计期支持还需要注册控件类别，在 InitInstance 里调用 AfxRegisterWndClass 并设置 CS_DBLCLKS 样式。

5.3 一个验证清单

改完代码后，按下面这个清单过一遍，能省掉大部分返工：

检查项	验证方法	预期结果
自绘样式	用 Spy++ 看窗口样式	包含 SS_OWNERDRAW
双缓冲	快速拖动窗口	无闪烁
悬停	鼠标移入移出	文字颜色切换
竖排	设置中文文本	逐字垂直排列
高 DPI	系统缩放调到 150%	文字不模糊
动态创建	用 Create 而非子类化	样式生效