正文

C++ MFC按钮控件继承详解 子类化重写OnClick方法实战教程 解决点击事件不响应和样式异常问题

/0 浏览量
0901

C++ MFC按钮控件继承详解 子类化重写OnClick方法实战教程 解决点击事件不响应和样式异常问题

先聊聊大家最常见的坑。

你是不是也遇到过这种情况：在对话框里拖了一个按钮，想着重写一下 OnClick，结果点按钮一点反应都没有，或者样式变成了系统默认的灰色按钮，丑得想哭？

我一开始写MFC的时候也踩过这个坑，折腾了整整一个下午。后来才发现，MFC的消息映射机制和C++的虚函数重写根本是两码事，用错方法的话，你写再多代码都是白搭。

这篇文章就是把这些年踩过的坑全填平，把按钮子类化的前前后后讲清楚。

一、MFC按钮子类化的两种正确姿势

先别急着上代码，我得先让你明白一个核心问题：MFC的消息处理机制和普通的虚函数重写完全是两回事。

很多刚接触MFC的朋友（包括以前的我）会想当然地认为，只要继承 CButton，然后重写 OnClick 方法就能搞定。结果代码写得满满当当，一运行，按钮点了跟没点一样，连编译错误都没有，静悄悄地失败了。

为什么直接重写 OnClick 不生效？

因为MFC的按钮点击消息是通过消息映射宏传递的，不是通过虚函数表传递的。WM_LBUTTONDOWN、BN_CLICKED 这些消息，走的是 ON_BN_CLICKED 宏，不是虚函数。

所以你有两条路可以走：

路线A：直接改消息映射（适合快速搞定） 在对话框类里重写 OnBnClickedButton1() 这类方法。

路线B：真正的子类化（适合复杂需求） 继承 CButton，重写虚函数如 PreTranslateMessage、OnPaint 等，完全掌控按钮行为。

我们今天重点讲路线B，因为这才是真正”继承+重写”的玩法，而且能解决样式异常和事件不响应的问题。

二、从零开始：创建一个自定义按钮类

新建一个MFC对话框项目（假设叫 MfcButtonDemo），然后我们创建自己的按钮类。

第一步：创建 CustomButton 类

CustomButton.h

#pragma once

// 自定义按钮类，继承自CButton
class CCustomButton : public CButton
{
    DECLARE_DYNAMIC(CCustomButton)

public:
    CCustomButton();
    virtual ~CCustomButton();

    // 设置按钮文本颜色
    void SetTextColor(COLORREF crColor);
    // 设置背景颜色
    void SetBkColor(COLORREF crColor);
    // 设置按钮文字
    void SetButtonText(const CString& strText);

protected:
    DECLARE_MESSAGE_MAP()

    // 重写绘制消息 - 自绘按钮的核心
    virtual void PreSubclassWindow();
    virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);
    
    // 重写鼠标消息，处理点击效果
    afx_msg void OnMouseMove(UINT nFlags, CPoint point);
    afx_msg void OnLButtonDown(UINT nFlags, CPoint point);
    afx_msg void OnLButtonUp(UINT nFlags, CPoint point);
    afx_msg void OnMouseMoveOver();

    // 存储自定义颜色
    COLORREF m_crTextColor;
    COLORREF m_crBkColor;
    COLORREF m_crHoverBkColor;
    CBrush m_brushBk;
    CString m_strText;
    bool m_bHover;      // 鼠标是否悬停
    bool m_bPressed;    // 按钮是否被按下
    CRect m_rectButton; // 按钮区域
};

CustomButton.cpp

#include "pch.h"
#include "CustomButton.h"

// 声明动态创建宏实现
IMPLEMENT_DYNAMIC(CCustomButton, CButton)

BEGIN_MESSAGE_MAP(CCustomButton, CButton)
    ON_WM_MOUSEMOVE()
    ON_WM_LBUTTONDOWN()
    ON_WM_LBUTTONUP()
END_MESSAGE_MAP()

CCustomButton::CCustomButton()
{
    m_crTextColor  = RGB(0, 0, 0);        // 默认黑色文字
    m_crBkColor    = RGB(52, 152, 219);   // 默认蓝色背景
    m_crHoverBkColor = RGB(41, 128, 185); // 悬停时更深的蓝色
    m_bHover      = false;
    m_bPressed    = false;
}

CCustomButton::~CCustomButton()
{
}

// 设置文字颜色
void CCustomButton::SetTextColor(COLORREF crColor)
{
    m_crTextColor = crColor;
    Invalidate(); // 重绘按钮
}

// 设置背景色
void CCustomButton::SetBkColor(COLORREF crColor)
{
    m_crBkColor = crColor;
    m_crHoverBkColor = DarkenColor(crColor, 15); // 悬停时颜色深一点
    m_brushBk.DeleteObject();
    m_brushBk.CreateSolidBrush(crColor);
    Invalidate();
}

// 设置按钮文字
void CCustomButton::SetButtonText(const CString& strText)
{
    m_strText = strText;
    SetWindowText(strText);
}

// 辅助函数：加深颜色
COLORREF CCustomButton::DarkenColor(COLORREF crColor, int nAmount)
{
    int nR = GetRValue(crColor);
    int nG = GetGValue(crColor);
    int nB = GetBValue(crColor);
    
    nR = max(0, nR - nAmount);
    nG = max(0, nG - nAmount);
    nB = max(0, nB - nAmount);
    
    return RGB(nR, nG, nB);
}

// 子类化时调用 - 这里最关键！
void CCustomButton::PreSubclassWindow()
{
    // 必须添加 BS_OWNERDRAW 风格，否则 DrawItem 不会被调用
    ModifyStyle(0, BS_OWNERDRAW);
    CButton::PreSubclassWindow();
    
    // 获取按钮区域
    GetClientRect(&m_rectButton);
    
    // 初始化画刷
    m_brushBk.DeleteObject();
    m_brushBk.CreateSolidBrush(m_crBkColor);
}

// 自绘核心：绘制按钮
void CCustomButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    CDC* pDC = CDC::FromHandle(lpDrawItemStruct->hDC);
    CRect rect = lpDrawItemStruct->rcItem;
    UINT state = lpDrawItemStruct->itemState;
    
    // 获取按钮文本
    CString strText;
    GetWindowText(strText);
    if (strText.IsEmpty())
        strText = _T("Button");
    
    // 根据状态确定绘制方式
    bool bFocused   = (state & ODS_FOCUS) != 0;
    bool bDisabled  = (state & ODS_DISABLED) != 0;
    bool bPressed   = (state & ODS_SELECTED) != 0;
    
    // 绘制背景
    CBrush* pOldBrush = pDC->SelectObject(&m_brushBk);
    
    if (bPressed)
        // 按下时稍微偏移，制造按下感
        rect.OffsetRect(2, 2);
    
    // 圆角矩形背景
    pDC->RoundRect(&rect, CPoint(6, 6));
    
    pDC->SelectObject(pOldBrush);
    
    // 绘制边框
    CPen pen(PS_SOLID, 1, bDisabled ? RGB(160, 160, 160) : RGB(255, 255, 255));
    CPen* pOldPen = pDC->SelectObject(&pen);
    pDC->SelectObject(GetStockObject(NULL_BRUSH));
    pDC->RoundRect(&rect, CPoint(6, 6));
    pDC->SelectObject(pOldPen);
    
    // 绘制文字
    pDC->SetBkMode(TRANSPARENT);
    
    if (bDisabled)
        pDC->SetTextColor(RGB(128, 128, 128));
    else
        pDC->SetTextColor(m_crTextColor);
    
    // 文字居中
    CRect textRect = rect;
    textRect.DeflateRect(8, 4);
    pDC->DrawText(strText, &textRect, DT_CENTER | DT_VCENTER | DT_SINGLELINE);
    
    // 焦点框
    if (bFocused)
    {
        rect.DeflateRect(2, 2);
        pDC->DrawFocusRect(&rect);
    }
}

// 鼠标悬停检测 - 配合定时器实现hover效果
void CCustomButton::OnMouseMove(UINT nFlags, CPoint point)
{
    if (!m_bHover)
    {
        m_bHover = true;
        // 切换为悬停颜色
        m_brushBk.DeleteObject();
        m_brushBk.CreateSolidBrush(m_crHoverBkColor);
        Invalidate();
    }
    
    CButton::OnMouseMove(nFlags, point);
}

// 鼠标按下
void CCustomButton::OnLButtonDown(UINT nFlags, CPoint point)
{
    m_bPressed = true;
    // 按下时变深
    m_crBkColor = m_crHoverBkColor;
    m_brushBk.DeleteObject();
    m_brushBk.CreateSolidBrush(m_crBkColor);
    Invalidate();
    
    CButton::OnLButtonDown(nFlags, point);
}

// 鼠标抬起
void CCustomButton::OnLButtonUp(UINT nFlags, CPoint point)
{
    m_bPressed = false;
    // 恢复颜色
    m_crBkColor = RGB(52, 152, 219); // 恢复原始蓝色
    m_brushBk.DeleteObject();
    m_brushBk.CreateSolidBrush(m_crBkColor);
    Invalidate();
    
    CButton::OnLButtonUp(nFlags, point);
}

三、在对话框中使用自定义按钮

光写按钮类还不够，你得把它放到对话框里才能看到效果。

方案一：动态创建（推荐新手使用）

这是最简单的方案，不需要修改 .rc 资源文件。

在对话框头文件中添加成员变量：

// DemoDlg.h
#pragma once
#include "afxwin.h"
#include "CustomButton.h"

class CDemoDlg : public CDialogEx
{
    // ... 其他代码 ...
    
    CCustomButton m_btnStart;
    CCustomButton m_btnStop;
    CCustomButton m_btnQuit;
    
    afx_msg void OnBnClickedBtnStart();
    afx_msg void OnBnClickedBtnStop();
    afx_msg void OnBnClickedBtnQuit();
};

在对话框的 OnInitDialog 中创建按钮：

// DemoDlg.cpp
BOOL CDemoDlg::OnInitDialog()
{
    CDialogEx::OnInitDialog();
    
    // ... 其他初始化代码 ...
    
    // 创建自定义按钮 - 关键步骤！
    // 第一个参数：按钮ID
    // 第二个参数：窗口样式，必须包含 WS_CHILD | WS_VISIBLE | BS_OWNERDRAW
    // 第三个参数：按钮位置和大小
    // 第四个参数：父窗口指针
    
    m_btnStart.Create(_T("开始"), 
                      WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, 
                      CRect(50, 50, 200, 90), 
                      this, 
                      IDC_BTN_START);
    
    m_btnStop.Create(_T("停止"), 
                     WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, 
                     CRect(50, 110, 200, 150), 
                     this, 
                     IDC_BTN_STOP);
    
    m_btnQuit.Create(_T("退出"), 
                     WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, 
                     CRect(50, 170, 200, 210), 
                     this, 
                     IDC_BTN_QUIT);
    
    // 设置按钮颜色
    m_btnStart.SetBkColor(RGB(46, 204, 113));  // 绿色 - 开始
    m_btnStop.SetBkColor(RGB(231, 76, 60));    // 红色 - 停止
    m_btnQuit.SetBkColor(RGB(52, 73, 94));     // 深灰 - 退出
    
    // 设置文字颜色
    m_btnStart.SetTextColor(RGB(255, 255, 255));
    m_btnStop.SetTextColor(RGB(255, 255, 255));
    m_btnQuit.SetTextColor(RGB(255, 255, 255));
    
    return TRUE;
}

消息映射：

BEGIN_MESSAGE_MAP(CDemoDlg, CDialogEx)
    ON_WM_SYSCOMMAND()
    ON_WM_PAINT()
    ON_WM_QUERYDRAGICON()
    ON_BN_CLICKED(IDC_BTN_START, &CDemoDlg::OnBnClickedBtnStart)
    ON_BN_CLICKED(IDC_BTN_STOP,  &CDemoDlg::OnBnClickedBtnStop)
    ON_BN_CLICKED(IDC_BTN_QUIT,  &CDemoDlg::OnBnClickedBtnQuit)
END_MESSAGE_MAP()

void CDemoDlg::OnBnClickedBtnStart()
{
    AfxMessageBox(_T("开始按钮被点击了！"));
}

void CDemoDlg::OnBnClickedBtnStop()
{
    AfxMessageBox(_T("停止按钮被点击了！"));
}

void CDemoDlg::OnBnClickedBtnQuit()
{
    EndDialog(IDCANCEL);
}

方案二：子类化现有按钮（适合已有资源文件）

如果你的对话框里已经用资源编辑器拖了按钮，可以通过子类化来改造它们。

在对话框头文件中：

#pragma once
#include "afxwin.h"
#include "CustomButton.h"

class CDemoDlg : public CDialogEx
{
    // ... 其他代码 ...
    
    // 用CWnd指针数组管理多个按钮，便于遍历
    CCustomButton m_btnCustom[3];
    
    afx_msg void OnBnClickedButton1();
    afx_msg void OnBnClickedButton2();
    afx_msg void OnBnClickedButton3();
};

在 OnInitDialog 中子类化：

BOOL CDemoDlg::OnInitDialog()
{
    CDialogEx::OnInitDialog();
    
    // 获取对话框中已有的按钮控件
    CButton* pBtn1 = (CButton*)GetDlgItem(IDC_BUTTON1);
    CButton* pBtn2 = (CButton*)GetDlgItem(IDC_BUTTON2);
    CButton* pBtn3 = (CButton*)GetDlgItem(IDC_BUTTON3);
    
    if (pBtn1) m_btnCustom[0].SubclassWindow(pBtn1->m_hWnd);
    if (pBtn2) m_btnCustom[1].SubclassWindow(pBtn2->m_hWnd);
    if (pBtn3) m_btnCustom[2].SubclassWindow(pBtn3->m_hWnd);
    
    // 设置样式
    m_btnCustom[0].SetBkColor(RGB(52, 152, 219));
    m_btnCustom[1].SetBkColor(RGB(231, 76, 60));
    m_btnCustom[2].SetBkColor(RGB(46, 204, 113));
    
    return TRUE;
}

关键： SubclassWindow 调用后，PreSubclassWindow 会被自动调用，里面我们设置了 BS_OWNERDRAW 风格，这样 DrawItem 就会生效。

四、点击事件不响应？常见原因和解决方案

这里我列举几个最常见的坑，每个都有对应的解决办法。

问题1：按钮创建了但点了没反应

症状： 程序运行正常，按钮也显示，但点击时什么事件都不触发。

原因： 消息映射ID不匹配，或者按钮没有正确创建。

检查清单：

// 检查1：确保Create调用在AddControl后，且ID正确
m_btnStart.Create(_T("开始"), WS_CHILD | WS_VISIBLE | BS_OWNERDRAW,
                  CRect(50, 50, 200, 90), this, IDC_BTN_START);
                  //                         ↑ 注意：BS_OWNERDRAW必须加！

// 检查2：确保消息映射中的ID和Create中的ID一致
ON_BN_CLICKED(IDC_BTN_START, &CDemoDlg::OnBnClickedBtnStart)

// 检查3：确保 .h 文件中的 DECLARE_MESSAGE_MAP 正确
// 检查4：确保按钮句柄有效
if (m_btnStart.m_hWnd == NULL)
{
    AfxMessageBox(_T("按钮创建失败！"));
}

问题2：DrawItem没有被调用

症状： DrawItem 函数写了，但按钮样式还是系统的灰色方块。

原因： 这是MFC自绘控件最常见的问题！BS_OWNERDRAW 风格必须设置。

解决方案：

// 方法一：在 PreSubclassWindow 中设置（推荐）
void CCustomButton::PreSubclassWindow()
{
    // 这一行是关键！没有它，DrawItem永远不会被调用
    ModifyStyle(0, BS_OWNERDRAW);
    CButton::PreSubclassWindow();
}

// 方法二：在Create时直接指定
m_btn.Create(_T("测试"), 
             WS_CHILD | WS_VISIBLE | BS_OWNERDRAW,  // BS_OWNERDRAW在这里
             CRect(50, 50, 200, 90), this, IDC_BTN);

// 方法三：在SubclassWindow后设置
m_btn.SubclassWindow(GetDlgItem(IDC_BTN)->m_hWnd);
m_btn.ModifyStyle(0, BS_OWNERDRAW);
m_btn.Invalidate(); // 强制重绘

问题3：子类化后按钮样式变成系统默认

症状： 本来按钮是自定义颜色，子类化后突然变回灰色的系统样式。

原因： 可能是窗口风格被其他代码覆盖了，或者 PreSubclassWindow 没有正确调用。

解决方案：

// 在 PreSubclassWindow 中确保风格正确
void CCustomButton::PreSubclassWindow()
{
    // 先保存原有风格
    DWORD dwStyle = GetStyle();
    
    // 移除可能导致问题的风格
    dwStyle &= ~BS_TYPEMASK;  // 清除按钮类型风格位
    
    // 添加自绘风格
    dwStyle |= BS_OWNERDRAW;
    
    // 重新设置风格
    ModifyStyle(0, BS_OWNERDRAW);
    
    CButton::PreSubclassWindow();
    
    // 确保画刷已初始化
    if (m_brushBk.m_hObject == NULL)
    {
        m_brushBk.CreateSolidBrush(m_crBkColor);
    }
}

问题4：按钮文字显示乱码或空白

症状： 按钮上文字不显示，或者显示的是乱码。

原因： 字符集问题（Unicode vs 多字节），或者字体设置问题。

解决方案：

// 方案一：确保使用正确的字符串类型
#ifdef UNICODE
    m_btn.Create(L"开始", WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, ...);
#else
    m_btn.Create(_T("开始"), WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, ...);
#endif

// 方案二：在DrawItem中设置字体
void CCustomButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    CDC* pDC = CDC::FromHandle(lpDrawItemStruct->hDC);
    
    // 设置字体 - 让文字更清晰
    CFont font;
    font.CreateFont(16, 0, 0, 0, FW_BOLD, FALSE, FALSE, FALSE,
                    DEFAULT_CHARSET, OUT_DEFAULT_PRECIS,
                    CLIP_DEFAULT_PRECIS, DEFAULT_QUALITY,
                    DEFAULT_PITCH | FF_SWISS, _T("Microsoft YaHei"));
    
    CFont* pOldFont = pDC->SelectObject(&font);
    
    // ... 绘制代码 ...
    
    pDC->SelectObject(pOldFont);
    font.DeleteObject();
}

问题5：鼠标事件（悬停、按下）不生效

症状： OnMouseMove、OnLButtonDown 等方法不触发。

原因： 消息映射缺失，或者按钮没有捕获鼠标。

解决方案：

// 确保消息映射正确
BEGIN_MESSAGE_MAP(CCustomButton, CButton)
    ON_WM_MOUSEMOVE()      // 鼠标移动
    ON_WM_LBUTTONDOWN()    // 鼠标左键按下
    ON_WM_LBUTTONUP()      // 鼠标左键抬起
    ON_WM_LBUTTONDBLCLK()  // 双击（可选）
END_MESSAGE_MAP()

// 在构造函数或PreSubclassWindow中启用鼠标追踪
void CCustomButton::PreSubclassWindow()
{
    CButton::PreSubclassWindow();
    
    // 启用鼠标悬停通知
    // TRACKMOUSEEVENT 结构体用于获取 WM_MOUSELEAVE
    m_tme.cbSize = sizeof(m_tme);
    m_tme.hwndTrack = m_hWnd;
    m_tme.dwFlags = TME_HOVER | TME_LEAVE;
    m_tme.dwHoverTime = 1;
    _TrackMouseEvent(&m_tme);
}

// 需要添加 WM_MOUSELEAVE 消息映射
BEGIN_MESSAGE_MAP(CCustomButton, CButton)
    ON_WM_MOUSEMOVE()
    ON_WM_LBUTTONDOWN()
    ON_WM_LBUTTONUP()
    ON_WM_MOUSELEAVE()  // 鼠标离开按钮
END_MESSAGE_MAP()

// 处理鼠标离开
void CCustomButton::OnMouseLeave()
{
    m_bHover = false;
    m_brushBk.DeleteObject();
    m_brushBk.CreateSolidBrush(m_crBkColor);
    Invalidate();
    
    CButton::OnMouseLeave();
}

五、完整实战：带状态切换的按钮

光会基础还不够，我们来做点实际的。假设你要做一个播放/暂停切换按钮，点击后状态变化，颜色和文字都跟着变。

// PlayPauseButton.h
#pragma once
#include "CustomButton.h"

class CPlayPauseButton : public CCustomButton
{
    DECLARE_DYNAMIC(CPlayPauseButton)

public:
    CPlayPauseButton();
    virtual ~CPlayPauseButton();

    // 切换播放/暂停状态
    void ToggleState();
    // 设置当前状态
    void SetPlaying(bool bPlaying);
    // 获取当前状态
    bool IsPlaying() const { return m_bPlaying; }

protected:
    DECLARE_MESSAGE_MAP()
    virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

private:
    bool m_bPlaying;
    void DrawPlayIcon(CDC* pDC, CRect& rect);
    void DrawPauseIcon(CDC* pDC, CRect& rect);
};

// PlayPauseButton.cpp
#include "pch.h"
#include "PlayPauseButton.h"

IMPLEMENT_DYNAMIC(CPlayPauseButton, CCustomButton)

BEGIN_MESSAGE_MAP(CPlayPauseButton, CCustomButton)
END_MESSAGE_MAP()

CPlayPauseButton::CPlayPauseButton()
{
    m_bPlaying = false;
    SetButtonText(_T("▶ 播放"));
    SetBkColor(RGB(46, 204, 113)); // 绿色-播放状态
}

CPlayPauseButton::~CPlayPauseButton()
{
}

void CPlayPauseButton::ToggleState()
{
    m_bPlaying = !m_bPlaying;
    
    if (m_bPlaying)
    {
        SetButtonText(_T("❚❚ 暂停"));
        SetBkColor(RGB(230, 126, 34)); // 橙色-暂停状态
    }
    else
    {
        SetButtonText(_T("▶ 播放"));
        SetBkColor(RGB(46, 204, 113)); // 绿色-播放状态
    }
    
    // 触发父窗口的通知消息
    CWnd* pParent = GetParent();
    if (pParent)
    {
        pParent->SendMessage(WM_USER_PLAY_PAUSE_CHANGED, 
                            m_bPlaying ? 1 : 0, 
                            (LPARAM)this);
    }
    
    Invalidate();
}

void CPlayPauseButton::SetPlaying(bool bPlaying)
{
    if (m_bPlaying != bPlaying)
    {
        ToggleState();
    }
}

void CPlayPauseButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    CDC* pDC = CDC::FromHandle(lpDrawItemStruct->hDC);
    CRect rect = lpDrawItemStruct->rcItem;
    UINT state = lpDrawItemStruct->itemState;
    
    // 绘制背景圆角矩形
    CBrush* pOldBrush = pDC->SelectObject(&m_brushBk);
    pDC->RoundRect(&rect, CPoint(8, 8));
    pDC->SelectObject(pOldBrush);
    
    // 绘制边框
    CPen pen(PS_SOLID, 2, RGB(255, 255, 255));
    pDC->SelectObject(&pen);
    pDC->SelectObject(GetStockObject(NULL_BRUSH));
    pDC->RoundRect(&rect, CPoint(8, 8));
    
    // 绘制图标（播放/暂停符号）
    CRect iconRect = rect;
    iconRect.DeflateRect(15, 10);
    
    if (m_bPlaying)
        DrawPauseIcon(pDC, iconRect);
    else
        DrawPlayIcon(pDC, iconRect);
    
    // 绘制文字
    pDC->SetBkMode(TRANSPARENT);
    pDC->SetTextColor(RGB(255, 255, 255));
    
    CString strText;
    GetWindowText(strText);
    
    CRect textRect = rect;
    textRect.DeflateRect(10, 35); // 给图标留出空间
    textRect.top = iconRect.bottom + 5;
    
    pDC->DrawText(strText, &textRect, DT_CENTER | DT_VCENTER | DT_SINGLELINE);
}

void CPlayPauseButton::DrawPlayIcon(CDC* pDC, CRect& rect)
{
    // 绘制三角形播放图标
    CPen pen(PS_SOLID, 2, RGB(255, 255, 255));
    pDC->SelectObject(&pen);
    pDC->SelectObject(GetStockObject(NULL_BRUSH));
    
    CPoint points[3];
    points[0] = CPoint(rect.left + 8, rect.top + rect.Height() / 2);
    points[1] = CPoint(rect.right - 5, rect.top + 5);
    points[2] = CPoint(rect.right - 5, rect.bottom - 5);
    
    pDC->Polygon(points, 3);
}

void CPlayPauseButton::DrawPauseIcon(CDC* pDC, CRect& rect)
{
    // 绘制两条竖线暂停图标
    CPen pen(PS_SOLID, 4, RGB(255, 255, 255));
    pDC->SelectObject(&pen);
    
    int lineX1 = rect.left + rect.Width() / 4;
    int lineX2 = rect.left + rect.Width() * 3 / 4;
    int lineTop = rect.top + 5;
    int lineBottom = rect.bottom - 5;
    
    pDC->MoveTo(lineX1, lineTop);
    pDC->LineTo(lineX1, lineBottom);
    
    pDC->MoveTo(lineX2, lineTop);
    pDC->LineTo(lineX2, lineBottom);
}

在对话框中使用：

// DemoDlg.cpp
BOOL CDemoDlg::OnInitDialog()
{
    CDialogEx::OnInitDialog();
    
    // 创建播放/暂停按钮
    m_btnPlayPause.Create(_T("▶ 播放"), 
                          WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, 
                          CRect(100, 100, 250, 160), 
                          this, 
                          IDC_BTN_PLAY_PAUSE);
    
    // 连接点击消息
    // 注意：这里我们通过覆盖默认行为来实现Toggle
    // 如果你需要在点击时执行额外逻辑，可以重写OnClick
    // 但MFC的CButton没有虚函数OnClick，需要通过BN_CLICKED消息
    
    return TRUE;
}

// 处理点击 - 在对话框消息映射中添加
ON_BN_CLICKED(IDC_BTN_PLAY_PAUSE, &CDemoDlg::OnBnClickedPlayPause)

void CDemoDlg::OnBnClickedPlayPause()
{
    m_btnPlayPause.ToggleState();
    
    // 你可以在这里添加额外的逻辑
    // 比如控制媒体播放器的播放/暂停
    if (m_btnPlayPause.IsPlaying())
    {
        // 开始播放
        PlayMedia();
    }
    else
    {
        // 暂停播放
        PauseMedia();
    }
}

六、深入：为什么用 BS_OWNERDRAW 而不是 WM_PAINT？

你可能会问，既然我能重写 OnPaint 或处理 WM_PAINT，为什么还要用 BS_OWNERDRAW + DrawItem？

这是一个很关键的问题，理解它就能彻底搞清楚MFC按钮的绘制机制。

WM_PAINT 方案的局限性

// ❌ 不推荐：在CButton派生类中重写OnPaint
void CMyButton::OnPaint()
{
    CPaintDC dc(this);
    CRect rect;
    GetClientRect(&rect);
    
    // 问题1：按钮有焦点、按下、禁用等状态需要处理
    // 问题2：WM_PAINT只在窗口需要重绘时触发，状态变化时可能不触发
    // 问题3：MFC内部绘制逻辑会被绕过，导致绘制结果异常
    dc.FillSolidRect(&rect, RGB(52, 152, 219));
}

这种方法有几个致命问题：

  1. 状态管理困难：焦点、按下、禁用等状态需要手动处理
  2. 重绘时机不可控：窗口被遮挡后恢复时，可能需要多次重绘
  3. 与MFC内部机制冲突：MFC对按钮有自己的一套绘制逻辑

BS_OWNERDRAW 方案的优势

// ✅ 推荐：使用自绘模式
void CMyButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    // 参数中已经包含了所有需要的信息：
    // lpDrawItemStruct->hDC    - 绘图DC
    // lpDrawItemStruct->rcItem - 绘制区域
    // lpDrawItemStruct->itemState - 当前状态（焦点、按下、禁用等）
    
    // MFC会自动在需要重绘时调用此函数
    // 状态变化时也会自动调用
}

DrawItem 是MFC专门给自绘控件设计的回调，它有几个优势：

  1. 状态信息完整：itemState 包含了所有状态标志
  2. 自动触发：焦点变化、窗口重绘等都会自动调用
  3. 兼容性最好：这是MFC推荐的自绘方式

七、常见问题排查清单

这里给你一份完整的排查清单，遇到问题时可以逐项检查：

点击事件不响应的排查顺序

□ 1. 消息映射是否正确添加？
   - 检查 BEGIN_MESSAGE_MAP 和 END_MESSAGE_MAP
   - 检查 ON_BN_CLICKED 的ID是否与按钮ID一致

□ 2. 按钮是否正确创建？
   - 检查 Create 调用是否成功（m_hWnd 不为NULL）
   - 检查父窗口指针是否正确

□ 3. 按钮样式是否正确？
   - 检查是否包含 WS_CHILD | WS_VISIBLE
   - 检查是否包含 BS_OWNERDRAW（如果用了DrawItem）

□ 4. 消息映射ID是否在 .h 文件中声明？
   - 检查 DECLARE_MESSAGE_MAP() 是否存在

□ 5. 是否有其他窗口拦截了消息？
   - 检查父窗口或祖先窗口是否有捕获

样式异常的排查顺序

□ 1. PreSubclassWindow 是否被调用？
   - 在函数开头加断点或AfxMessageBox确认

□ 2. BS_OWNERDRAW 是否设置成功？
   - 调用 GetStyle() 检查是否包含 BS_OWNERDRAW 标志

□ 3. DrawItem 是否被调用？
   - 在DrawItem开头加断点确认

□ 4. 画刷是否正确初始化？
   - 检查 m_brushBk 是否有效（m_hObject 不为NULL）

□ 5. 颜色是否正确传递？
   - 检查 SetBkColor/SetTextColor 是否被调用

八、性能优化建议

当你在对话框中创建多个自定义按钮时，需要注意性能问题。

避免在 DrawItem 中创建对象

// ❌ 性能差：每次重绘都创建新字体
void CCustomButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    CFont font;  // 每次绘制都创建
    font.CreateFont(...);
    // ...
}

// ✅ 性能好：字体只创建一次
class CCustomButton : public CButton
{
private:
    CFont m_font;  // 成员变量，整个生命周期内只创建一次
    
public:
    void InitFont()
    {
        m_font.CreateFont(16, 0, 0, 0, FW_BOLD, FALSE, FALSE, FALSE,
                         DEFAULT_CHARSET, OUT_DEFAULT_PRECIS,
                         CLIP_DEFAULT_PRECIS, DEFAULT_QUALITY,
                         DEFAULT_PITCH | FF_SWISS, _T("Microsoft YaHei"));
    }
    
    void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
    {
        CDC* pDC = CDC::FromHandle(lpDrawItemStruct->hDC);
        pDC->SelectObject(&m_font);  // 直接使用
        // ...
    }
};

使用双缓冲减少闪烁

void CCustomButton::DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct)
{
    CDC* pDC = CDC::FromHandle(lpDrawItemStruct->hDC);
    CRect rect = lpDrawItemStruct->rcItem;
    
    // 创建内存DC进行双缓冲绘制
    CDC memDC;
    memDC.CreateCompatibleDC(pDC);
    
    CBitmap bitmap;
    bitmap.CreateCompatibleBitmap(pDC, rect.Width(), rect.Height());
    
    CBitmap* pOldBitmap = memDC.SelectObject(&bitmap);
    
    // 在内存DC中绘制
    memDC.FillSolidRect(&rect, RGB(240, 240, 240)); // 背景
    // ... 其他绘制操作 ...
    
    // 一次性复制到屏幕DC
    pDC->BitBlt(rect.left, rect.top, rect.Width(), rect.Height(), 
                &memDC, 0, 0, SRCCOPY);
    
    memDC.SelectObject(pOldBitmap);
    bitmap.DeleteObject();
    memDC.DeleteDC();
}

九、总结：MFC按钮子类化的核心要点

聊到这里，我把最重要的几个点再捋一遍，方便你记住：

第一，消息映射不是虚函数。 这是很多新手最容易混淆的地方。MFC的按钮点击走的是 ON_BN_CLICKED 宏，不是虚函数重写。如果你想通过继承 CButton 来拦截点击，你需要用 PreTranslateMessage 或者 ON_BN_CLICKED 消息映射。

第二，自绘必须加 BS_OWNERDRAW 风格。 不管是 Create 时指定，还是 PreSubclassWindow 里 ModifyStyle，这一行代码是关键。没它，DrawItem 永远不被调用。

第三，子类化要在对话框初始化时完成。 最佳位置是 OnInitDialog，在调用 CDialogEx::OnInitDialog() 之后立即进行。

第四，状态变化要主动通知重绘。 当你改变了按钮的颜色、文字等状态后，记得调用 Invalidate() 让MFC知道需要重绘。

第五，消息映射要配对。 BEGIN_MESSAGE_MAP 和 END_MESSAGE_MAP 必须成对出现，ON_BN_CLICKED 的ID必须和按钮的ID一致。

写到这里，相信你对MFC按钮的子类化和自定义绘制已经有比较全面的理解了。这些都是实打实用过的方法，如果你在实际使用中遇到问题，记得先对照排查清单逐项检查，大部分问题都能自己解决。

MFC虽然老，但它的机制设计其实很合理，只是文档写得不够直白。希望这篇文章能帮你少走弯路。

-- 展开阅读全文 --