Qt07鼠标事件

个人认为，事件机制是Qt最难以理解且最为精妙的一部分。事件主要分为两种：

  1. 在与用户交互时发生。比如按下鼠标（mousePressEvent），敲击键盘（keyPressEvent）等。
  2. 系统自动发生，比如计时器事件（timerEvent）等。

在发生事件时（比如说上面说的按下鼠标），就会产生一个QEvent对象（这里是QMouseEvent，为QEvent的子类），这个QEvent对象会传给当前组件的event函数。如果当前组件没有安装事件过滤器（这个后面会提到），则会被event函数发放到相应的xxxEvent函数中（这里是mousePressEvent函数）。

需要区分的是：事件与信号并不相同。

比如：鼠标单击按钮，鼠标事件（QMouseEvent），而按钮本身发射clicked（）信号。一般而言我们只需要关注单击信号，不用考虑鼠标事件。但是当我们要对该按钮做额外操作，不想通过信号处理，此时事件就是一个很好的选择。关闭事件（QCloseEvent）是一个常用的事件。

一，事件

Qt 中所有事件类都继承于 QEvent。在事件对象创建完毕后，Qt 将这个事件对象传递给 QObject 的 event()函数。event()函数并不直接处理事件，而是按照事件对象的类型分派给特定的事件处理函数（eventhandler）。

信号是通过connect（）来绑定槽函数处理响应，那么事件是怎么处理的呢？

处理事件有5种常用的方法：

  1. 重新实现部件的paintEvent（）、mousePressEvent()等事件处理函数。这是最常用的一种方法，不过只能用来处理特定部件的特定事件（即需要新建类去实现）
  2. 重新实现notify（）函数。这个函数的功能强大，提供了完全的控制，可以再事件过滤器得到事件之间就获得他们。但是，它一次只能处理一个事件。
  3. 向QApplication对象上安装事件过滤器。因为一个程序只有一个QApplication对象，实现的功能和notify（）函数相同，优点是可以同时处理多个事件。
  4. 重新实现event（）函数。QObject类的event（）函数可以在事件达到默认事件处理函数之前获得该事件。
  5. 在对象上安装事件过滤器。使用事件过滤器可以再一个界面类中同时处理不同子部件的事件（在本类中实现）

实际编程中最常用的是方法（1），其次是方法（5）。方法2要继承QApplication类，方法3需要全局的事件过滤器，减缓事件的传递。

鼠标事件：

常用的鼠标事件：（本篇处理事件用的是方法一：重写鼠标事件）

  • void mousePressEvent(QMouseEvent *event); //单击
  • void mouseReleaseEvent(QMouseEvent *event); //释放
  • void mouseDoubleClickEvent(QMouseEvent *event); //双击
  • void mouseMoveEvent(QMouseEvent *event); //移动
  • void wheelEvent(QWheelEvent *event); //滑轮

鼠标事件使用的时候，加头文件： #include

重写事件框架：

1️⃣鼠标按下事件

1
2
3
4
5
6
7
8
9
10
11
void Widget::mousePressEvent(QMouseEvent *event)
{
    // 如果是鼠标左键按下   
    if(event->button() == Qt::LeftButton){
        ···
    }
    // 如果是鼠标右键按下
    else if(event->button() == Qt::RightButton){
       ···
    }
}

2️⃣鼠标移动事件

1
2
3
4
5
6
7
void Widget::mouseMoveEvent(QMouseEvent *event)
{
    // 这里必须使用buttons()
    if(event->buttons() & Qt::LeftButton){  //进行的按位与
       ···
    }
}

默认情况下，触发事件需要点击一下，才能触发。可设置为自动触发:setMouseTracking(true);

3️⃣鼠标释放事件

1
2
3
4
void Widget::mouseReleaseEvent(QMouseEvent *event)
{
   ···
}

4️⃣鼠标双击事件

1
2
3
4
5
6
7
8
void Widget::mouseDoubleClickEvent(QMouseEvent *event)
{
    // 如果是鼠标左键按下
    if(event->button() == Qt::LeftButton){
      
        ···
    }
}

5️⃣滚轮事件

1
2
3
4
5
6
7
8
9
void Widget::wheelEvent(QWheelEvent *event)
{
    // 当滚轮远离使用者时
    if(event->delta() > 0){
        ···
    }else{//当滚轮向使用者方向旋转时
        ···
    }
}

实例演示（在label控件中，移动鼠标获取实时位置，并显示在界面上）

  • 创建mylabel类，基类设置为QLabel

这里用了类似自定义控件的方法，对Mylabel类进行封装。设置基类QLabel 是为了在ui界面中提升label控件（即将label控件和Mylabel关联，提升时候必须二者基类相同）

  • 在mylabel.h中声明鼠标事件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
#pragma once
#include <qlabel.h>

class mylabel : public QLabel
{
public:
    mylabel(QWidget* parent = 0);
    ~mylabel();
public:
    //鼠标移动事件
    void mouseMoveEvent(QMouseEvent* event);
    //鼠标按下事件
    void mousePressEvent(QMouseEvent* event);
    //鼠标释放事件
    void mouseReleaseEvent(QMouseEvent* event);
};
  • 在mylabel.cpp中重写事件
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
#include "mylabel.h"
#include"QMouseEvent"


mylabel::mylabel(QWidget* parent) :QLabel(parent)
{
    
}
mylabel::~mylabel()
{

}
//鼠标移动显示坐标
void mylabel::mouseMoveEvent(QMouseEvent* event)
{
    if (event->buttons() & Qt::LeftButton)  //进行的按位与（只有左键点击移动才满足）
    { 
        QString str = QString("Move:(X:%1,Y:%2)").arg(event->x()).arg(event->y());
         this->setText(str);
         
    }
    
}
//鼠标按下显示“ok，mouse is press”
void mylabel::mousePressEvent(QMouseEvent* event)
{
    setText("Ok, mouse is press");

}
//鼠标释放清除显示
void mylabel::mouseReleaseEvent(QMouseEvent* event)
{
    setText(" ");
}
  • 在主函数（QTest.cpp）中声明mylabel的类对象（即声明一个mylabel类的label控件）
1
2
3
4
5
6
7
8
9
10
#include "qtest.h"

QTest::QTest(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);    //声明mylabel类的控件
    mylabel* label1 = new mylabel(this);
    label1->setGeometry(QRect(130, 100, 271, 161));    //设置边框
    label1->setFrameShape(QFrame::Panel);
}

另外，当调用setMouseTracking(true);时（即设置鼠标状态为自动触发），需要将鼠标移动事件的if语句去掉（因为不需要点击触发了）

修改maylabel.cpp事件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
#include "mylabel.h"
#include"QMouseEvent"


mylabel::mylabel(QWidget* parent) :QLabel(parent)
{
    //设置鼠标状态（自动触发）
    setMouseTracking(true);
}
mylabel::~mylabel()
{

}
//鼠标移动显示坐标
void mylabel::mouseMoveEvent(QMouseEvent* event)
{
   QString str = QString("Move:(X:%1,Y:%2)").arg(event->x()).arg(event->y());
   this->setText(str);
}
//鼠标按下显示“ok，mouse is press”
void mylabel::mousePressEvent(QMouseEvent* event)
{
    setText("Ok, mouse is press");

}
//鼠标释放清除显示
void mylabel::mouseReleaseEvent(QMouseEvent* event)
{
    setText(" ");
}

效果展示：

😒这里用的是代码创建label控件，那么能不能用ui界面编辑然后在对label控件提升呢？

答案是可以的，但是需要注意的是：此处不能选择全局包含

否则会出现：

我想其中的原因主要是因为：

本实例是新建了一个mylabel类，而不是像QT常用控件（三）——自定义控件封装 - 唯有自己强大 - 博客园 (cnblogs.com)这篇博文中直接新添加了一个设计师界面类（即包含ui .h .cpp)。当选择全局包含时，就包含了主类。

其实也有解决的办法：需要在提升界面的头文件处，将工程目录下自定义控件的地址放于此处

二，事件的分发：event函数

上面提到的xxxEvent函数，称为事件处理器（event handler）。而event函数的作用就在于事件的分发。如果想在事件的分发之前就进行一些操作，比如监听（阻塞）鼠标按下事件。

如果希望在事件分发之前做一些操作，就可以重写这个 event()函数了。比如我们希望阻塞鼠标按下事件，那么我们就在新建的Mylabel类中重写event()函数（该类的父类是QLabel）

  • 在Mylabel.h中声明event事件
1
2
3
4
5
6
7
8
9
10
11
12
13
#include"qlabel.h"
class Mylabel : public QLabel
{
public:
    explicit Mylabel(QWidget* parent = 0);

    //鼠标按下事件
    void mousePressEvent(QMouseEvent* event); 
    //鼠标释放事件
    void mouseReleaseEvent(QMouseEvent* event);
    //声明event事件
    bool event(QEvent* e);
};
  • 在Mylabel.cpp中重写event事件。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
#include "Mylabel.h"
#include"QMouseEvent"

Mylabel::Mylabel(QWidget* parent) :QLabel(parent)
{

}

//重写鼠标按下事件
void Mylabel::mousePressEvent(QMouseEvent* event)
{
    this->setText(QString("mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
}
//重写鼠标释放事件
void Mylabel::mouseReleaseEvent(QMouseEvent* event)
{
    this->setText("mouse is release ");
}
//重写event事件
bool Mylabel::event(QEvent* e)
{
    //如果鼠标按下，再事件分发中做拦截
    if (e->type()==QEvent::MouseButtonPress)
    {        //静态转换（将QEvent的对象转换为QMouseEvent对象）
        QMouseEvent* event = static_cast<QMouseEvent*>(e);
        this->setText(QString("event mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
        return true;//返回ture，说明用户自己处理事件，不往下分发（即拦截上面的按下事件）
    }
    return QLabel::event(e);
}

点击鼠标可以看到，触发的是event的事件（即阻塞了mousePressEvent的事件）。特别需要注意的是：在将不需要阻塞分发的时候，需要分发给父类的event函数处理。即（return QLable::event(e)；)

由此可以见，event()是一个集中处理不同类型的事件的地方。如果你不想重写一大堆事件处理器，就可以重写这个 event()函数，通过 QEvent::type()判断不同的事件。鉴于重写 event()函数需要十分小心注意父类的同名函数的调用，一不留神就可能出现问题，所以一般还是建议只重写事件处理器（当然，也必须记得是不是应该调用父类的同名处理器）。

三，事件过滤器（Even Filter）

某些应用场景下，需要拦截某个组件发生的事件，让这个事件不再向其他组件进行传播，这时候可以为这个组件或其父组件安装一个事件过滤器，该过滤器在event分发之前进行拦截。

事件的过滤有两个步骤：

1️⃣对QObject组件安装过滤器（调用installEvenFilter函数）

1
void QObject::installEventFilter ( QObject * filterObj );

参数filterobj 是指谁为组件安装过滤器（一般是父类）

  • 这个函数接受一个 QObject *类型的参数。记得刚刚我们说的，eventFilter()函数是 QObject 的一个成员函数，因此，任意 QObject 都可以作为事件过滤器（问题在于，如果你没有重写 eventFilter()函数，这个事件过滤器是没有任何作用的，因为默认什么都不会过滤）。已经存在的过滤器则可以通过**QObject::removeEventFilter()**函数移除。
  • 我们可以向一个对象上面安装多个事件处理器 ，只要调用多次installEventFilter()函数。如果一个对象存在多个事件过滤器，那么，最后一个安装的会第一个执行，也就是后进先执行的顺序。

2️⃣事件过滤器的重写（evenFilter函数）

1
virtual bool QObject::eventFilter ( QObject * watched, QEvent * event );

可以看到，函数有两个参数，一个为具体发生事件的组件，一个为发生的事件（产生的QEvent对象）。当事件是我们感兴趣的类型，可以就地进行处理，并令其不再转发给其他组件。函数的返回值也是bool类型，作用跟even函数类似，返回true为不再转发，false则让其继续被处理。

实例：通过事件过滤器阻塞上面代码中的鼠标按下事件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
#include "qtest.h"
#include"qmouseevent"

QTest::QTest(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);
    //第一步：给label添加过滤器
    ui.label->installEventFilter(this);


}
//第二步：重写过滤事件
bool QTest::eventFilter(QObject* obj, QEvent* e)
{
    if (obj == ui.label)
    {
        //如果鼠标按下，再事件分发中做拦截
        if (e->type() == QEvent::MouseButtonPress)
        {
            QMouseEvent* event = static_cast<QMouseEvent*>(e);
            ui.label->setText(QString("eventfilter mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
            return true;//返回ture，说明用户自己处理事件，不往下分发（即拦截上面的按下事件）
        }
    }
    return QWidget::eventFilter(obj, e);
}

//重写鼠标按下事件
void QTest::mousePressEvent(QMouseEvent* event)
{
    ui.label->setText(QString("mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
}

//重写事件分发
bool QTest::event(QEvent* e)
{
    //如果鼠标按下，再事件分发中做拦截
    if (e->type() == QEvent::MouseButtonPress)
    {
        QMouseEvent* event = static_cast<QMouseEvent*>(e);
        ui.label->setText(QString("event mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
        return true;//返回ture，说明用户自己处理事件，不往下分发（即拦截上面的按下事件）
    }
    return QWidget::event(e);
}

运行结果：

可以看到在过滤器事件中就监听了鼠标按压（即阻塞了后面的事件分发和鼠标按压）

按钮长按事件

最近在做qt项目，需要对button按钮添加一个长按事件（比如点击按钮，开始运动。松开按钮，运动停止）。查了些许资料，（差点误把QPushButton的press信号和长按事件混淆）在此记录一下经验。

setAutoRepeat

以前一直以为QPushButton不支持长按，才发现还有这个功能。用起来很简单：

1
2
3
4
5
6
7
QPushButton *pBtnSub = new QPushButton(this);
pBtnSub = setAutoRepeat(true);  //启动长按
pBtnSub = setAutoRepeatDelay(400);  // 触发长按时间
pBtnSub = setAutoRepeatInterval(50);  // 长按时click信号间隔
connect(pBtnSub,&QPushButton::clicked,[&]{
    qDebug() << "send";
});

MouseEvent中没有repeat这个东西的，所以一个按钮被鼠标点击还能连续触发，那基本就是一个定时器做出来的。

所以应该说是鼠标按下Delay时间后会启动一个多次触发的TimerEvent（定时器），由timeOut再次触发click槽。

QPushButton 点击信号分析

再来分析一下QPushButton的点击信号。QPushButton有三个很重要的信号跟点击有关：

  • pressed
  • clicked
  • toggled

表面上看，pressed和clicked都会在点击按钮时触发，它们有什么区别呢？toggled好像有时候触发，有时候不触发，到底怎么回事呢？下面就一起聊一下这三个信号

😊验证过程就不放了，直接给结论吧！

首先，这三个信号都是从QAbstractButton继承来的，也就是说，下面情况对QAbstractButton的所有子类都适用

结论：

  1. pressed最先执行，相当于按下操作
  2. 按下之后，按钮状态发生变化，触发toggled
  3. clicked最后执行，相当于弹起操作



转载自：唯有自己强大 如有侵权，在下方评论 立刻删除。