详解Qt事件处理机制

详解Qt事件处理机制

引用

CSDN

1.

https://m.blog.csdn.net/m0_56069910/article/details/141784537

Qt的事件处理机制是开发Qt应用程序的核心内容之一。本文将详细介绍Qt事件处理的基本概念、处理方法以及各种常见事件的处理方式，包括按键事件、鼠标事件、定时器事件等。通过本文的学习，读者将能够掌握Qt事件处理的基本原理和具体实现方法。

事件介绍

事件是应用程序内部或者外部产生的事情或者动作的统称。在Qt中使用一个对象来表示一个事件。所有的Qt事件均继承于抽象类QEvent。事件是由系统或者Qt平台本身在不同的时刻发出的。当用户按下鼠标、敲下键盘，或者是窗口需要重新绘制的时候，都会发出一个相应的事件。一些事件是在用户操作时发出，如键盘事件、鼠标事件等，另一些事件则是由系统本身自动发出，如定时器事件。

常见事件描述：

事件的处理

事件处理一般常用的方法为：重写相关的Event函数。在Qt中，几乎所有的Event函数都是虚函数，所以可以重新实现。如：在实现鼠标的进入和离开事件时，直接重新实现enterEvent()和leaveEvent()即可。

示例1：鼠标进入和离开事件

1. 新建Qt项目，基类选择QWidget，同时勾选UI界面文件
2. 设计UI文件
3. 在项目中新添加一个类：MyLabel
4. 在帮助文档中查找对应的内容
5. 复制enterEvent()，粘贴在项目文件mylabel.h中
6. 重写enterEvent()方法
7. 在UI文件中选中Label，右键------>提升为...
8. 修改基类
9. 执行效果：当鼠标进入设计好的标签之后，就会在应用程序输出栏中打印：鼠标进入（同理鼠标离开也是一样）

示例2：鼠标点击事件

1. 在上述示例的基础上，在mylabel.h中声明mousePressEvent()方法

//当鼠标点击时，获取对应的坐标值
void mousePressEvent(QMouseEvent *event);
//鼠标释放操作
void mouseReleaseEvent(QMouseEvent *event);

2. 在mylabel.cpp中重写mousePressEvent()方法

void mylabel::mousePressEvent(QMouseEvent *event)
{
    //按下右键
    if(event->button() == Qt::RightButton){
        //基于global
        qDebug() << "鼠标右键已经按下 x = "<<event->globalX();
        qDebug() << "鼠标右键已经按下 x = "<<event->globalY();
    }
    //按下左键
    if(event->button() == Qt::LeftButton){
        //基于窗口的坐标
        qDebug() << "鼠标左键已经按下 x = "<<event->x();
        qDebug() << "鼠标左键已经按下 x = "<<event->y();
    }
    //按下中间键
    if(event->button() == Qt::MidButton){
        qDebug() << "鼠标已经按下 x = "<<event->x();
        qDebug() << "鼠标已经按下 x = "<<event->y();
    }
}
void mylabel::mouseReleaseEvent(QMouseEvent *event)
{
    if(event->button() == Qt::LeftButton){
        qDebug() << "左键被释放";
    }
    else if(event->button() == Qt::RightButton){
         qDebug() << "右键被释放";
    }else if(event->button() == Qt::MidButton){
         qDebug() << "中键被释放";
    }
}

按键事件

在Qt框架中，处理按键事件是交互式应用程序的一个重要方面。按键事件主要涉及QKeyEvent类，它提供了关于键盘事件的信息，如按键的类型、状态等。

单个按键

示例：当某个按键被按下时，输出：某个按键被按下了；

1. 新建项目，在头文件widget.h中声明虚函数keyPressEvent()
2. 在widget.cpp文件中重写keyPressEvent()虚函数

组合按键

在Qt助手中搜索：Qt::KeyboardModifier，如下图示：

Qt::KeyboardModifier中定义了在处理键盘事件时对应的修改键。在Qt中，键盘事件可以与修改键一起使用，以实现一些复杂的交互操作。KeyboardModifier中修改键的具体描述如下：

鼠标事件

在Qt框架中，处理鼠标事件是创建交互式图形用户界面的关键部分。鼠标事件包括鼠标点击、双击、移动、滚轮滚动等。这些事件由QMouseEvent类表示，它提供了关于鼠标事件的详细信息，如鼠标位置、按钮状态等。

鼠标单击事件

在Qt中，鼠标按下是通过虚函数mousePressEvent()来捕获的。mousePressEvent()函数原型如下：

[virtual protected] void QWidget::mousePressEvent(QMouseEvent *event)

鼠标左右键及滚的表示如下：

• Qt::LeftButton 鼠标左键
• Qt::RightButton 鼠标右键
• Qt::MidButton 鼠标滚轮

鼠标释放事件

鼠标释放事件是通过虚函数mouseReleaseEvent()来捕获的。mouseReleaseEvent()函数原型如下：

[virtual protected] void QWidget::mouseReleaseEvent(QMouseEvent *event)

鼠标双击事件

鼠标双击事件是通过虚函数：mouseDoubleClickEvent()来实现的。mouseDoubleClickEvent()函数原型如下：

[virtual protected] void QWidget::mouseDoubleClickEvent(QMouseEvent *event)

void mylabel::mouseDoubleClickEvent(QMouseEvent *event)
{
    if(event->button() == Qt::LeftButton){
        qDebug() << "左键被双击";
    }else if(event->button() == Qt::RightButton){
        qDebug() << "右键被双击";
    }else if(event->button() == Qt::MidButton){
        qDebug() << "中键被双击";
   }
}

鼠标移动事件

鼠标移动事件是通过虚函数：mouseMoveEvent()来实现的。同时为了实时捕获鼠标位置信息，需要通过函数setMouseTracking()来追踪鼠标的位。mouseMoveEvent()函数原型如下：

[virtual protected] void QWidget::mouseMoveEvent(QMouseEvent*event)
///
//setMouseTracking()函数原型如下：
void setMouseTracking(bool enable)
说明：
setMouseTracking() 函数默认是false，需要设置为true，才能实时捕获鼠标位置信息;
否则只有当鼠标按下时才能捕获其位置信息。

滚轮事件

在Qt中，鼠标滚轮事件是通过QWheelEvent类来实现的。滚轮滑动的距离可以通过delta()函数获取。delta()函数原型如下：

int QGraphicsSceneWheelEvent::delta() const

其中返回值代表滚轮滑动的距离。正数表示滚轮相对于用户向前滑动，负数表示滚轮相对于用户向后滑动。

void Widget::wheelEvent(QWheelEvent *event)
{
    //滚轮事件
    static int x = 0;
    x += event->delta();
    if(event->delta() > 0){
        qDebug() << "滚轮向前移动了" << x;
    }
    else if(event->delta() < 0){
         qDebug() << "滚轮向后移动了" << x;
    }
}

定时器

Qt 中在进行窗口程序的处理过程中，经常要周期性的执行某些操作，或者制作一些动画效果，使用定时器就可以实现。所谓定时器就是在间隔一定时间后，去执行某一个任务。定时器在很多场景下都会使用到，如弹窗自动关闭之类的功能等。

Qt中的定时器分为QTimerEvent和QTimer这2个类。

• QTimerEvent类用来描述一个定时器事件。在使用时需要通过startTimer()函数来开启一个定时器，这个函数需要输入一个以毫秒为单位的整数作为参数来表明设定的时间，它返回的整型值代表这个定时器。当定时器溢出时（即定时时间到达）就可以在timerEvent()函数中获取该定时器的编号来进行相关操作。
• QTimer类来实现一个定时器，它提供了更高级的编程接口，如：可以使用信号和槽，还可以设置只运行一次的定时器。

QTimerEvent类

示例：在UI界面上放置控件，程序启动开始倒计时操作

void Widget::timerEvent(QTimerEvent *event)
{
    //先判定触发的是否为想要触发的
    if(event->timerId() != this->timerid){
        return;
    }
    int value = ui->lcdNumber->intValue();
    if(value <= 0){
        //停止定时器
        this->killTimer(this->timerid);
        return;
    }
    value -= 1;
    ui->lcdNumber->display(value);
}

QTimer类

示例：在UI界面放置一个Label标签，两个按钮，分别是"开始"和"停止"，当点击"开始"按钮时，开始每隔1秒计数一次，点击"停止"按钮时，暂停计数。

ui->setupUi(this);

QTimer *time = new QTimer(this);
connect(ui->btn1 , &QPushButton::clicked,[=](){
    time->start(1000);
});
connect(time , &QTimer::timeout,[=](){
    static int num = 1;
    ui->label->setText(QString::number (num++));
});
connect(ui->btn2 , &QPushButton::clicked,[=](){
    time->stop();
});

事件分发器

概述

在Qt中，事件分发器(EventDispatcher)是一个核心概念，用于处理GUI应用程序中的事件。事件分发器负责将事件从一个对象传递到另一个对象，直到事件被处理或被取消。每个继承自QObject类或QObject类本身都可以在本类中重写bool event(QEvent*e)函数，来实现相关事件的捕获和拦截。

工作原理

在Qt中，我们发送的事件都是传给了QObject对象，更具体点是传给了QObject对象的event()函数。所有的事件都会进入到这个函数里面，那么我们处理事件就要重写这个event()函数。event()函数本身不会去处理事件，而是根据事件类型（type值）调用不同的事件处理函数。事件分发器就是工作在应用程序向下分发事件的过程中。

事件分发器用于分发事件。在此过程中，事件分发器也可以做拦截操作。事件分发器主要是通过bool event(QEvent*e)函数来实现。其返回值为布尔类型，若为ture，代表拦截，不向下分发。

Qt 中的事件是封装在QEvent类中，在Qt助手中输入QEvent可以查看其所包括的事件类型。

示例：

1. 在widget.h头文件中声明鼠标点击事件和事件分发器
2. 在widget.cpp文件中实现鼠标点击事件和拦截事件

事件过滤器

在Qt中，一个对象可能经常要查看或拦截另外一个对象的事件，如对话框想要拦截按键事件，不让别的组件接收到，或者修改按键的默认值等。通过上面的学习，我们已经知道，Qt创建了QEvent事件对象之后，会调用QObject的event()函数处理事件的分发。显然，我们可以在event()函数中实现拦截的操作。由于event()函数是protected的，因此，需要继承已有类。如果组件很多，就需要重写很多个event()函数。这当然相当麻烦，更不用说重写event()函数还得小心一堆问题。好在Qt提供了另外一种机制来达到这个目的：事件过滤器。

事件过滤器是在应用程序分发到event事件分发器之前，再做一次更高级的拦截。

事件过滤器的一般使用步骤：

1. 安装事件过滤器
2. 重写事件过滤器函数：eventfilter()

示例：

1. 新建Qt项目，基类选择QWidget，同时勾选UI界面文件
2. 设计UI文件
3. 在项目新添加一个类：MyLabel
4. 在UI文件中选中Label，右键------>提升为...
5. 在mylabel.h中声明鼠标点击事件和事件分发器
6. 在mylabel.cpp文件中实现鼠标点击事件和事件分发器
7. 在widget.h头文件中声明事件过滤器函数
8. 在widget.cpp文件中实现事件过滤器的两个步骤

执行结果如下：

总结

Qt的事件处理机制非常灵活，通过事件循环、事件对象、信号与槽机制以及事件过滤器，可以高效地处理各种用户交互和系统事件。理解这些概念对于开发复杂的Qt应用程序至关重要。