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

一、场景

常常会需要实现点击/hover时修改图片,可能是一个QPushButtonQLabelQToolButton......

由于Qt bug,QIcon/QSS只能实现常规态、按下态的图标切换,hover态的图片设置无效。

解决思路无非是安装事件过滤器、自定义类并重实现事件。

然而,总要为这些鸡毛蒜皮的操作"小动干戈"会让人不爽。

这里选择更通用的类模板来简化操作。

二、实现说明

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

  2. 如果一定要使用信号,那么就要用一个类来代理信号的发送。

    比如下面定义了InteractiveSignalSender,只用于发送信号。

    绑定时信号发送者需要调getSignalSender()

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

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

    cpp 复制代码
    // InteractivePushButton.h
    #pragma once
    #include "interactiveTemplate.h"
    
    using InteractivePushButton = Interactive<QPushButton>;

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

三、实现

使用例子:

cpp 复制代码
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

cpp 复制代码
#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);
}
相关推荐
心情好的小球藻13 分钟前
Python应用进阶DAY9--类型注解Type Hinting
开发语言·python
惜.己25 分钟前
使用python读取json数据,简单的处理成元组数组
开发语言·python·测试工具·json
Y40900132 分钟前
C语言转Java语言,相同与相异之处
java·c语言·开发语言·笔记
古月-一个C++方向的小白6 小时前
C++11之lambda表达式与包装器
开发语言·c++
沐知全栈开发6 小时前
Eclipse 生成 jar 包
开发语言
杭州杭州杭州7 小时前
Python笔记
开发语言·笔记·python
tanyongxi668 小时前
C++ AVL树实现详解:平衡二叉搜索树的原理与代码实现
开发语言·c++
阿葱(聪)9 小时前
java 在k8s中的部署流程
java·开发语言·docker·kubernetes
浮生带你学Java9 小时前
2025Java面试题及答案整理( 2025年 7 月最新版,持续更新)
java·开发语言·数据库·面试·职场和发展
斯是 陋室9 小时前
在CentOS7.9服务器上安装.NET 8.0 SDK
运维·服务器·开发语言·c++·c#·云计算·.net