类模板实现实现Qt click/hover自定义操作

一、场景

常常会需要实现点击/hover时修改图片，可能是一个QPushButton、QLabel、QToolButton……

由于Qt bug，QIcon/QSS只能实现常规态、按下态的图标切换，hover态的图片设置无效。
解决思路无非是安装事件过滤器、自定义类并重实现事件。

然而，总要为这些鸡毛蒜皮的操作“小动干戈”会让人不爽。
这里选择更通用的类模板来简化操作。

二、实现说明

1. Q_OBJECT不能在类模板中使用，导致我们不能在模板类中设置信号。不过也不是刚需，上面的场景回调函数足够用了。

2. 如果一定要使用信号，那么就要用一个类来代理信号的发送。
   比如下面定义了InteractiveSignalSender，只用于发送信号。
   绑定时信号发送者需要调getSignalSender()

   注意，只能通过组合的方式。如果通过多继承的方式，例如让模板类继承QObject，会出现重复继承QObject（因为WidgetType也继承自QObject），QObject不支持多重继承，会有问题。

3. 如果需要在Qt Deigner中使用，需要提升，那么可以单独写个头文件来放入模板实例，例如：

   // InteractivePushButton.h
   #pragma once
   #include "interactiveTemplate.h"
   
   using InteractivePushButton = Interactive<QPushButton>;
   

   然后添加该头文件，选择提升为InteractivePushButton即可。

三、实现

使用例子：

ui.btnFeedback->setEnterCallback([&] { ui.btnFeedback->setIcon(QIcon(":/img/hover.png")); });
ui.btnFeedback->setLeaveCallback([&] { ui.btnFeedback->setIcon(QIcon(":/img/simple.png")); });
ui.btnFeedback->setClickCallback([&] { ui.btnFeedback->setIcon(QIcon(":/imgpressed.png")); });

connect(ui.btnFeedback->signalSender(), &InteractiveSignalSender::signalEnter, this, [] {});

模板实现如下：
InteractiveTemplate.h

#pragma once

#include <QWidget>

class InteractiveSignalSender : public QObject {
	Q_OBJECT
public:
	explicit InteractiveSignalSender(QObject *parent) : QObject(parent)
	{
	}

Q_SIGNALS:
	void signalEnter();
Q_SIGNALS:
	void signalLeave();
};

template <typename WidgetType>
class Interactive : public WidgetType {
public:
	explicit Interactive(QWidget *parent = nullptr);

	void setEnterCallback(std::function<void()> callback);

	void setLeaveCallback(std::function<void()> callback);

	void setClickCallback(std::function<void()> callback);

	InteractiveSignalSender *signalSender();

protected:
	void mousePressEvent(QMouseEvent *event) override;

	void enterEvent(QEvent *event) override;

	void leaveEvent(QEvent *event) override;
private:
	std::function<void()> m_enterCallback	= nullptr;
	std::function<void()> m_leaveCallback	= nullptr;
	std::function<void()> m_clickCallback	= nullptr;
	InteractiveSignalSender *m_signalSender = new InteractiveSignalSender(this);
	static_assert(std::is_base_of<QWidget, WidgetType>::value, "WidgetType must be a QWidget");
};

template <typename WidgetType>
Interactive<WidgetType>::Interactive(QWidget *parent) : WidgetType(parent)
{
}

template <typename WidgetType>
InteractiveSignalSender *
Interactive<WidgetType>::signalSender()
{
	return m_signalSender;
}

template <typename WidgetType>
void
Interactive<WidgetType>::setEnterCallback(std::function<void()> callback)
{
	m_enterCallback = callback;
}

template <typename WidgetType>
void
Interactive<WidgetType>::setLeaveCallback(std::function<void()> callback)
{
	m_leaveCallback = callback;
}

template <typename WidgetType>
void
Interactive<WidgetType>::setClickCallback(std::function<void()> callback)
{
	m_clickCallback = callback;
}

template <typename WidgetType>
void
Interactive<WidgetType>::mousePressEvent(QMouseEvent *event)
{
	if (m_clickCallback) {
		m_clickCallback();
	}
	WidgetType::mousePressEvent(event);
}

template <typename WidgetType>
void
Interactive<WidgetType>::enterEvent(QEvent *event)
{
	emit m_signalSender->signalEnter();
	if (m_enterCallback) {
		m_enterCallback();
	}
	WidgetType::enterEvent(event);
}

template <typename WidgetType>
void
Interactive<WidgetType>::leaveEvent(QEvent *event)
{
	emit m_signalSender->signalLeave();
	if (m_leaveCallback) {
		m_leaveCallback();
	}
	WidgetType::leaveEvent(event);
}