基于CMFCPropertyGridProperty自定义嵌入按钮并检测状态问题

在CDialog环境下使用CMFCPropertyGridCtrl时，默认的m_bButtonIsFocused和m_bButtonIsDown变量无法自动更新，导致无法实现按钮悬停/按下的样式切换，核心原因是对话框的消息路由未将鼠标、焦点消息正确传递给属性项，需要手动在派生属性类中处理这些消息并更新状态。

解决方案步骤 #

1. 派生自定义属性类并添加消息映射 #

创建继承自CMFCPropertyGridProperty的派生类，重载鼠标、焦点相关消息处理函数，手动更新状态变量并触发重绘。

头文件（MyPropertyGridProperty.h）

#pragma once
#include <afxpropertygridctrl.h>

class CMyPropertyGridProperty : public CMFCPropertyGridProperty
{
    DECLARE_DYNAMIC(CMyPropertyGridProperty)
public:
    CMyPropertyGridProperty(const CString& strName, const COleVariant& varValue, LPCTSTR lpszDescr = nullptr, DWORD_PTR dwData = 0);
    virtual ~CMyPropertyGridProperty();

protected:
    // 重载按钮绘制函数，根据状态自定义样式
    virtual void DrawButton(CDC* pDC, CRect rectButton) override;

    // 消息处理函数
    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 OnKillFocus(CWnd* pNewWnd);
    afx_msg void OnSetFocus(CWnd* pOldWnd);

    DECLARE_MESSAGE_MAP()
};

实现文件（MyPropertyGridProperty.cpp）

#include "pch.h"
#include "MyPropertyGridProperty.h"

IMPLEMENT_DYNAMIC(CMyPropertyGridProperty, CMFCPropertyGridProperty)

CMyPropertyGridProperty::CMyPropertyGridProperty(const CString& strName, const COleVariant& varValue, LPCTSTR lpszDescr, DWORD_PTR dwData)
    : CMFCPropertyGridProperty(strName, varValue, lpszDescr, dwData)
{
}

CMyPropertyGridProperty::~CMyPropertyGridProperty()
{
}

BEGIN_MESSAGE_MAP(CMyPropertyGridProperty, CMFCPropertyGridProperty)
    ON_WM_MOUSEMOVE()
    ON_WM_LBUTTONDOWN()
    ON_WM_LBUTTONUP()
    ON_WM_KILLFOCUS()
    ON_WM_SETFOCUS()
END_MESSAGE_MAP()

void CMyPropertyGridProperty::OnMouseMove(UINT nFlags, CPoint point)
{
    CRect btnRect;
    GetButtonRect(btnRect);
    const bool isInBtn = btnRect.PtInRect(point);

    if (isInBtn != m_bButtonIsFocused)
    {
        m_bButtonIsFocused = isInBtn;
        Invalidate(); // 触发重绘更新样式
    }

    CMFCPropertyGridProperty::OnMouseMove(nFlags, point);
}

void CMyPropertyGridProperty::OnLButtonDown(UINT nFlags, CPoint point)
{
    CRect btnRect;
    GetButtonRect(btnRect);
    if (btnRect.PtInRect(point))
    {
        m_bButtonIsDown = TRUE;
        Invalidate();
    }

    CMFCPropertyGridProperty::OnLButtonDown(nFlags, point);
}

void CMyPropertyGridProperty::OnLButtonUp(UINT nFlags, CPoint point)
{
    if (m_bButtonIsDown)
    {
        m_bButtonIsDown = FALSE;
        Invalidate();
    }

    CMFCPropertyGridProperty::OnLButtonUp(nFlags, point);
}

void CMyPropertyGridProperty::OnKillFocus(CWnd* pNewWnd)
{
    m_bButtonIsFocused = FALSE;
    Invalidate();

    CMFCPropertyGridProperty::OnKillFocus(pNewWnd);
}

void CMyPropertyGridProperty::OnSetFocus(CWnd* pOldWnd)
{
    m_bButtonIsFocused = TRUE;
    Invalidate();

    CMFCPropertyGridProperty::OnSetFocus(pOldWnd);
}

void CMyPropertyGridProperty::DrawButton(CDC* pDC, CRect rectButton)
{
    // 根据状态绘制不同样式的按钮
    UINT btnStyle = DFCS_BUTTONPUSH;
    if (m_bButtonIsDown)
    {
        btnStyle |= DFCS_PUSHED;
    }
    else if (m_bButtonIsFocused)
    {
        btnStyle |= DFCS_HOT;
    }

    pDC->DrawFrameControl(rectButton, DFC_BUTTON, btnStyle);

    // 可在此添加自定义图标/文字绘制逻辑
}

2. 确保对话框消息路由正确传递 #

如果对话框重载了PreTranslateMessage，需优先让属性控件处理消息，避免拦截鼠标事件：

BOOL CYourDialog::PreTranslateMessage(MSG* pMsg)
{
    if (m_wndPropertyGrid.PreTranslateMessage(pMsg))
    {
        return TRUE;
    }
    return CDialogEx::PreTranslateMessage(pMsg);
}

3. 使用自定义属性类添加属性项 #

在对话框中初始化属性控件时，使用派生的CMyPropertyGridProperty类创建属性：

void CYourDialog::InitPropertyGrid()
{
    COleVariant varValue(_T(""));
    auto pBtnProperty = new CMyPropertyGridProperty(_T("自定义按钮属性"), varValue, _T("点击按钮触发操作"));
    pBtnProperty->EnableButton(TRUE); // 启用按钮
    m_wndPropertyGrid.AddProperty(pBtnProperty);
}

关键说明 #

• GetButtonRect用于获取属性项中按钮的区域，判断鼠标是否在按钮范围内。
• 每次状态变更后调用Invalidate()触发控件重绘，确保样式及时更新。
• 若需要更复杂的按钮样式，可在DrawButton中自行绘制图标、背景色等，替代默认的DrawFrameControl。

内容的提问来源于stack exchange，提问作者Andrew Truckle