QT自定义QPushButton如何在鼠标悬停时切换图标并恢复？

要在你的MyButton类中实现鼠标悬停切换图标、离开恢复初始图标的功能，只需要重写鼠标进入/离开的事件处理函数，并存储初始图标即可，不会影响你已有的背景图切换逻辑。

步骤1：添加成员变量存储初始图标 #

在MyButton的头文件中，添加一个私有成员变量用于保存按钮的初始图标：

#include <QPushButton>
#include <QIcon>

class MyButton : public QPushButton
{
    Q_OBJECT
public:
    explicit MyButton(QWidget *parent = nullptr);
    // 可选：如果需要外部动态设置图标时同步更新初始图标，重写setIcon
    void setIcon(const QIcon &icon) override;

protected:
    // 根据Qt版本选择参数类型：Qt5用QEvent*，Qt6用QEnterEvent*
    void enterEvent(QEnterEvent *event) override;
    void leaveEvent(QEvent *event) override;

private:
    QIcon m_defaultIcon; // 存储按钮的初始图标
};

步骤2：实现构造函数与事件处理函数 #

在MyButton的实现文件中，完成构造函数、鼠标事件处理函数的编写：

#include "MyButton.h"

MyButton::MyButton(QWidget *parent) : QPushButton(parent)
{
    // 保存初始图标（如果构造时已经设置了初始图标，这里会自动获取）
    m_defaultIcon = this->icon();
}

// Qt6版本的enterEvent
void MyButton::enterEvent(QEnterEvent *event)
{
    // 设置鼠标悬停时的目标图标，替换为你的实际图标路径
    this->setIcon(QIcon(":/icons/hover_icon.png"));
    // 必须调用父类的事件处理，保证原有背景图切换逻辑正常执行
    QPushButton::enterEvent(event);
}

// 如果是Qt5，将enterEvent改为以下形式：
// void MyButton::enterEvent(QEvent *event)
// {
//     this->setIcon(QIcon(":/icons/hover_icon.png"));
//     QPushButton::enterEvent(event);
// }

void MyButton::leaveEvent(QEvent *event)
{
    // 恢复为初始图标
    this->setIcon(m_defaultIcon);
    // 调用父类事件处理，保证原有背景图恢复逻辑正常执行
    QPushButton::leaveEvent(event);
}

// 可选：重写setIcon，确保外部动态设置图标时同步更新初始图标
void MyButton::setIcon(const QIcon &icon)
{
    QPushButton::setIcon(icon);
    m_defaultIcon = icon;
}

关键注意事项 #

• Qt版本适配：Qt6对enterEvent的参数类型做了调整，从QEvent*改为QEnterEvent*，根据你使用的Qt版本选择对应的函数签名。
• 图标路径：将代码中的:/icons/hover_icon.png替换为你实际的悬停图标路径，可以是Qt资源文件路径，也可以是本地文件的绝对/相对路径。
• 父类事件调用：一定要调用QPushButton::enterEvent(event)和QPushButton::leaveEvent(event)，否则你已实现的背景图切换逻辑会失效。
• 动态图标更新：如果需要外部代码动态修改按钮图标时，初始图标也能同步更新，就重写setIcon函数，同步更新m_defaultIcon。

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