当前位置：首页 > article >正文

MFC 实现按钮按下持续执行

article 2024/12/2 17:39:02

在MFC开发中，有时需要实现按钮按下时持续执行某项操作，并在松开按钮时停止该操作。比如在运动控制场景中，JOG+ 和 JOG- 按钮通常需要这样的功能。本文将介绍两种实现这种需求的方法：通过 PreTranslateMessage 函数在消息调度前进行筛选，或者通过重载 CButton 类来添加自定义的鼠标事件。

方案一：使用 PreTranslateMessage 进行消息筛选

实现思路

PreTranslateMessage 是 MFC 提供的一个用于在窗口消息调度之前对消息进行预处理的函数。我们可以利用这个函数来检测特定按钮的鼠标按下和抬起事件，从而控制操作的开始和停止。

实现步骤

重载 PreTranslateMessage 函数

在对话框类中重载 PreTranslateMessage 函数，捕获鼠标按下和松开的消息。

BOOL CAxisSettingsDlg::PreTranslateMessage(MSG* pMsg)
{
    if (pMsg->message == WM_LBUTTONDOWN || pMsg->message == WM_LBUTTONUP)
    {
        CWnd* pWnd = CWnd::FromHandle(pMsg->hwnd);
        if (pWnd)
        {
            int nCtrlID = pWnd->GetDlgCtrlID();
            if (nCtrlID == IDC_BUTTON_AXIS_TEST_JOG_ADD || nCtrlID == IDC_BUTTON_AXIS_TEST_JOG_SUB)
            {
                if (pMsg->message == WM_LBUTTONDOWN)
                {
                    handleAxisOperation(nCtrlID == IDC_BUTTON_AXIS_TEST_JOG_ADD ? AxisOperationType::JOG_ADD : AxisOperationType::JOG_SUB, true);
                    StartJogOperation(nCtrlID == IDC_BUTTON_AXIS_TEST_JOG_ADD ? AxisOperationType::JOG_ADD : AxisOperationType::JOG_SUB);
                }
                else if (pMsg->message == WM_LBUTTONUP)
                {
                    handleAxisOperation(nCtrlID == IDC_BUTTON_AXIS_TEST_JOG_ADD ? AxisOperationType::JOG_ADD : AxisOperationType::JOG_SUB, false);
                    StopJogOperation();
                }
                return TRUE; // 消息已处理
            }
        }
    }
    return CDialogEx::PreTranslateMessage(pMsg);
}

解释实现细节
- 在 PreTranslateMessage 中，我们对 WM_LBUTTONDOWN 和 WM_LBUTTONUP 消息进行筛选。
- 使用 FromHandle 获取对应的窗口对象，通过控件 ID 判断是否是我们关注的按钮。
- 对 JOG+ 和 JOG- 按钮，分别在按下和松开时调用 handleAxisOperation 函数开始或停止操作。

使用定时器实现持续执行

在 WM_LBUTTONDOWN 消息处理中，启动一个定时器以持续执行操作。
在 WM_LBUTTONUP 消息处理中，停止定时器。

void CAxisSettingsDlg::StartJogOperation(AxisOperationType opType)
{
    m_nJogOperationType = opType;
    SetTimer(TIMER_JOG_OPERATION, 100, nullptr); // 每隔100毫秒执行一次
}

void CAxisSettingsDlg::StopJogOperation()
{
    KillTimer(TIMER_JOG_OPERATION);
}

void CAxisSettingsDlg::OnTimer(UINT_PTR nIDEvent)
{
    if (nIDEvent == TIMER_JOG_OPERATION)
    {
        handleAxisOperation(m_nJogOperationType, true);
    }
    CDialogEx::OnTimer(nIDEvent);
}

优缺点

优点：实现简单，直接对对话框中的消息进行统一处理，减少对控件的直接操作。
缺点：需要在 PreTranslateMessage 中判断多个控件的 ID，当控件较多时，代码复杂度增加。

PreTranslateMessage 的其他应用和注意事项

PreTranslateMessage 函数在 MFC 中使用非常广泛，除了用于处理鼠标按下和松开的事件外，还可以用于：

全局快捷键处理：可以在 PreTranslateMessage 中捕获键盘消息，实现对全局快捷键的处理。
输入验证：在将消息传递给控件之前，可以对用户的输入进行验证，例如限制输入字符的范围。
防止某些消息传递：通过在 PreTranslateMessage 中直接返回 TRUE，可以阻止某些消息传递给控件。

需要注意的是，如果在 PreTranslateMessage 中处理的逻辑过多，可能会影响界面的响应速度，特别是在需要频繁判断控件 ID 的情况下。建议仅在必要时使用该函数进行消息处理。

方案二：重载 `CButton` 类以处理鼠标事件

实现思路

另一种方法是创建一个继承自 CButton 的新类，在其中重载 WM_LBUTTONDOWN 和 WM_LBUTTONUP 消息。这样，我们可以直接在按钮类中实现按下和抬起的逻辑，代码更加清晰，易于维护。

实现步骤

创建新的按钮类 CJOGControlButton

创建一个继承自 CButton 的类，重载 OnLButtonDown 和 OnLButtonUp 事件。

class CJOGControlButton : public CButton
{
public:
    DECLARE_MESSAGE_MAP()

    afx_msg void OnLButtonDown(UINT nFlags, CPoint point);
    afx_msg void OnLButtonUp(UINT nFlags, CPoint point);
    afx_msg void OnTimer(UINT_PTR nIDEvent);

    // 添加一个回调函数，用于执行特定操作
    void SetCallback(std::function<void(bool)> callback) { m_callback = callback; }
    void StartTimer() { SetTimer(1, 100, nullptr); } // 启动定时器持续执行
    void StopTimer() { KillTimer(1); } // 停止定时器

private:
    std::function<void(bool)> m_callback;
};

BEGIN_MESSAGE_MAP(CJOGControlButton, CButton)
    ON_WM_LBUTTONDOWN()
    ON_WM_LBUTTONUP()
    ON_WM_TIMER()
END_MESSAGE_MAP()

void CJOGControlButton::OnLButtonDown(UINT nFlags, CPoint point)
{
    if (m_callback)
        m_callback(true); // 开始操作
    StartTimer(); // 启动定时器持续执行
    CButton::OnLButtonDown(nFlags, point);
}

void CJOGControlButton::OnLButtonUp(UINT nFlags, CPoint point)
{
    if (m_callback)
        m_callback(false); // 停止操作
    StopTimer(); // 停止定时器
    CButton::OnLButtonUp(nFlags, point);
}

void CJOGControlButton::OnTimer(UINT_PTR nIDEvent)
{
    if (m_callback)
        m_callback(true); // 持续操作
    CButton::OnTimer(nIDEvent);
}

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

将按钮控件替换为自定义的 CJOGControlButton 类型，并在对话框中进行绑定。

DDX_Control(pDX, IDC_BUTTON_AXIS_TEST_JOG_ADD, m_btnJogAdd);
DDX_Control(pDX, IDC_BUTTON_AXIS_TEST_JOG_SUB, m_btnJogSub);

// 设置回调函数
m_btnJogAdd.SetCallback([this](bool bPressed) {
    handleAxisOperation(AxisOperationType::JOG_ADD, bPressed);
});
m_btnJogSub.SetCallback([this](bool bPressed) {
    handleAxisOperation(AxisOperationType::JOG_SUB, bPressed);
});