【QT开发笔记-基础篇】| 第四章 事件QEvent | 4.3 鼠标进入、离开事件

本章要实现的整体效果如下:

整体效果
QEvent::Enter

​ 鼠标进入事件,当鼠标进入到窗口/控件内部时,触发该事件,它对应的子类是 QEnterEvent

QEvent::Leave

​ 鼠标离开事件,当鼠标进入到窗口/控件内部时,触发该事件


本节通过鼠标进入和离开一个标签,来演示这这两个事件


1. 通过自定义控件实现

自定义一个标签控件 LabelX,让它继承自 QLabel,然后重写父类的 enterEventleaveEvent


(1)添加自定义控件类 LabelX

首先,在左侧项目文件名上右键,然后选择 “添加新文件”,选择 “C++ Class”,如下:

image-20230910122740383

新建类文件信息如下:

image-20230910203400853


然后,把父类修改为 QLabel

来到 labelx.h 将父类由 QWidget 修改为 QLabel,如下:

#include <QLabel>

class LabelX : public QLabel
{
	//
};

来到 labelx.cpp 将父类由 QWidget 修改为 QLabel,如下:

#include "labelx.h"

LabelX::LabelX(QWidget* parent) : QLabel{parent}
{
}

(2)重写 enterEvent/leaveEvent

首先,来到 labelx.h,声明这两个函数:

class LabelX : public QLabel
{
protected:
    // 鼠标进入/离开事件
    void enterEvent(QEvent* event);
    void leaveEvent(QEvent* event);
};

然后,来到 labelx.cpp 实现这两个函数:

static int cnt = 1;

void LabelX::enterEvent(QEvent* event)
{
    Q_UNUSED(event)
    //    qDebug() << "enterEvent: " << cnt++;
    this->setText(QString("enterEvent: %1").arg(cnt++));
}

void LabelX::leaveEvent(QEvent* event)
{
    Q_UNUSED(event)
    //    qDebug() << "leaveEvent: " << cnt++;
    this->setText(QString("leaveEvent: %1").arg(cnt++));
}

可以通过 qDebug() 在控制台输出,不过为了更直观,直接显示到标签上;

定义了一个静态变量,实现对进入和离开的计数;

使用 Q_UNUSED 宏,可以消除 “unused parameter” 的警告;


(3)将 LabelX 显示到界面

来到 enter_leave_widget.cpp,在构造函数中添加 LabelX 控件,如下:

EnterLeaveWidget::EnterLeaveWidget(QWidget* parent) : QWidget{parent}
{
    QVBoxLayout* verticalLayout = new QVBoxLayout(this);
    verticalLayout->setSpacing(0);
    verticalLayout->setContentsMargins(0, 0, 0, 0);

    // 1. 添加一个自定义的标签 LabelX
    LabelX* lblX = new LabelX(this);
    lblX->setText("");
    lblX->setFrameShape(QFrame::Box);
    lblX->setFixedHeight(50);
    lblX->setAlignment(Qt::AlignCenter);
    lblX->setStyleSheet("background-color: red;color: white;font-size: 25px");
    verticalLayout->addWidget(lblX);
}

此时运行程序,每当鼠标进入和离开标签时,计数都会加1,如下:

image-20230910210225425


2. 通过事件过滤器实现

给一个目标对象,安装一个事件过滤器对象,语法如下:

monitoredObj->installEventFilter(filterObj);

这样:

  • 所有发向 monitoredObj 的事件,都会被 filterObj 截获/过滤

  • 截获/过滤的位置是 filterObjeventFilter() 函数中

  • eventFilter() 函数返回一个 bool 类型, 返回 true 表示事件被截获,不再发送给 monitoredObj ,返回 false 表示事件会接着传递给 monitoredObj

接下来,通过一个案例来演示事件过滤器的使用:


(1)添加一个 QLabel

首先,在 enter_leave_widget.h 文件中添加一个 QLabel 的成员变量,如下:

#include <QLabel>

class EnterLeaveWidget : public QWidget
{
private:
    QLabel* lbl;
};

然后,在 enter_leave_widget.cpp 的构造中,添加一个 QLabel 控件,如下:

EnterLeaveWidget::EnterLeaveWidget(QWidget* parent) : QWidget{parent}
{
    // 2. 添加一个标准的QLabel
    lbl = new QLabel(this);
    lbl->setText("");
    lbl->setFrameShape(QFrame::Box);
    lbl->setFixedHeight(50);
    lbl->setAlignment(Qt::AlignCenter);
    lbl->setStyleSheet("background-color: blue;color: white;font-size: 25px");
    verticalLayout->addWidget(lbl);
}

(2)为 QLabel 安装事件过滤器

enter_leave_widget.cpp 的构造中,为 QLabel 控件安装事件过滤器,如下:

EnterLeaveWidget::EnterLeaveWidget(QWidget* parent) : QWidget{parent}
{
    // ...
    lbl->installEventFilter(this);
}

这里将 lbl 的事件过滤器指定为 this,那么所有的发给 lbl 的事件都会被当前窗口截获。


(3)重写 eventFilter() 函数

重写当前窗口的 eventFilter() 函数

首先,在 enter_leave_widget.h 文件中声明该函数,如下:

class EnterLeaveWidget : public QWidget
{
protected:
    bool eventFilter(QObject* watched, QEvent* event);
};

然后,在 enter_leave_widget.cpp 文件中实现该函数,如下:

#include <QEvent>

static int cnt = 1;
// 查看帮助文档, 拷贝
bool EnterLeaveWidget::eventFilter(QObject* watched, QEvent* event)
{
    if ( watched == lbl ) {
        if ( event->type() == QEvent::Enter ) {
            lbl->setText(QString("enterEvent: %1").arg(cnt++));
        } else if ( event->type() == QEvent::Leave ) {
            lbl->setText(QString("leaveEvent: %1").arg(cnt++));
        }
    }

    return QWidget::eventFilter(watched, event);
}

注意:

这里判断下事件是否是发向 lbl 的,然后再做处理,因为还有可能监控其他的控件;

通过 QEvent 类的 type() 函数,可以判断事件的类型;

以上还通过一个静态变量,来对事件计数;

最后调用下父类的 QWidget::eventFilter(watched, event),其他事件交由父类处理;


此时运行,在当前窗口就可以截获发向 QLabel 的进入和离开事件了,如下:

image-20230911091440215

  • 4
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 5
    评论
评论 5
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

大轮明王讲QT

你的鼓励将是我创作的最大动力!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值