Qt开发⑨Qt的事件_事件处理_按键事件和鼠标事件

目录

1. 事件简介

2. 事件的处理

3. 键盘按键事件

3.1 单个按键

3.2 组合按键

4. 鼠标事件

4.1 鼠标单击事件

4.2 鼠标释放事件

4.3 鼠标双击事件

4.4 鼠标移动事件

4.5 滚轮事件

5. 定时器

5.1 QTimerEvent 类

5.2 QTimer 类

6. 事件分发器

7. 事件过滤器

本篇完。

1. 事件简介

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

常见的 Qt 事件如下：

不同场景下，要关注的点不一样。这些事件的子类中就会包含一些对应的不同属性。

常见事件描述：

2. 事件的处理

事件处理一般常用的方法为：重写相关的 Event 函数。

        在 Qt 中，几乎所有的 Event 函数都是虚函数，所以可以重新实现。比如：在实现鼠标的进入和离开事件时，直接重新实现 enterEvent() 和 leaveEvent() 即可。enterEvent() 和 leaveEvent() 函数原型如下：

示例一

（1）新建 Qt 项目

基类选择 QWidget，同时勾选 UI 界面文件：

（2）设计 UI 文件

（3）在项目中新添加一个类

先选中项目名称 QEvent，点击鼠标右键，选择 add new ... ，弹出如下对话框：

（4）定义类名并选择基类

（5）此时项目中会新添加以下两个文件

（6）在帮助文档中查找对应的内容

（7）点击 “显示” 之后：

（8）复制 enterEvent()，粘贴在项目文件 "label.h" 中

要想重写父类的函数就需要确保写的函数名字和函数的参数列表完全一致（形参名无所谓）。

（9）重写 enterEvent() 和 leaveEvent() 方法

（10）在 UI 文件中选中 Label，右键 ——> 提升为...

（11）当点击 “提升为...” 之后

        通过 “提升为...” 这样的方式就可以把 Qt Designer 中托上去的控件的类型转换成自定义的控件类型。

（12）修改基类

（13）执行效果

        当鼠标进入设计好的标签之后，就会在应用程序输出栏中打印：enterEvent；鼠标移出设计好的标签之后，就会在应用程序输出栏中打印：leaveEvent。

此时就说明当前的 enterEvent 和 leaveEvent 这两个事件就被我们给捕获到了。

示例二，当鼠标点击时，获取对应的坐标值：

（1）在 label.h 中声明 mousePressEvent() 方法

（2）在 label.cpp 中重写 mousePressEvent() 方法

鼠标左键点击时，打印对应的坐标值，鼠标右键点击时，打印基于屏幕的坐标。

实现效果如下：

3. 键盘按键事件

        Qt 中的按键事件是通过 QKeyEvent 类来实现的。当键盘上的按键被按下或者被释放时，键盘事件便会触发。

在帮助文档中查找 QKeyEvent 类如下：

查找按键事件中所有的按键类型：在帮助文档中输入：Qt::Key，如下图：

3.1 单个按键

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

1. 新建项目，在头文件 "widget.h" 中声明虚函数 keyPressEvent()；如下图：

2. 在 "widget.cpp" 文件中重写 keyPressEvent() 虚函数

3.2 组合按键

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

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

示例：

4. 鼠标事件

        在 Qt 中，鼠标事件是用 QMouseEvent 类来实现的。当在窗口中按下鼠标或者移动鼠标时，都会产生鼠标事件。

        利用 QMouseEvent 类可以获取鼠标的哪个键被按下了以及鼠标的当前位置等信息。在 Qt 帮助文档中查找 QMouseEvent 类如下图示：

4.1 鼠标单击事件

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

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

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

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

鼠标左键，操作演示：

1. 在 "widget.h" 头文件中声明鼠标按下事件

2. 在 "widget.cpp" 文件中重新实现 mousePressEvent() 函数

实现效果如下：

鼠标右键，操作演示：

实现效果如下：

鼠标滚轮，操作演示：

实现效果如下：

4.2 鼠标释放事件

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

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

示例：

执行效果如下：

4.3 鼠标双击事件

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

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

示例：鼠标左键双击

执行效果如下：

4.4 鼠标移动事件

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

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

setMouseTracking() 函数原型如下：

void setMouseTracking( bool enable )

        说明：setMouseTracking() 函数默认是 false，需要设置为 true，才能实时捕获鼠标位置信息。否则只有当鼠标按下时才能捕获其位置信息。

示例：

执行效果：

4.5 滚轮事件

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

int QGraphicsSceneWheelEvent:: delta() const

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

示例：

执行效果如下：

5. 定时器

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

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

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

5.1 QTimerEvent 类

示例 1：在 UI 界面上放置一个 LCD Number 控件，让其 10 秒数字不断递减到 0，类似倒计时。

1. 新建项目，在 UI 界面文件放置一个 LCD Number 控件

2. 在 "widget.h" 头文件中声明 timerEvent() 函数，并定义一个整型变量

3. 在 "widget.cpp" 文件中重写 timerEvent() 函数

实现效果如下：

5.2 QTimer 类

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

1. 设计 UI 界面

2. 在 "widget.cpp" 文件中实现对应功能

实现效果如下：

示例：获取系统日期及时间

在 Qt 中，获取系统的日期及实时时间可以通过 QTimer 类和 QDateTime 类。

        QDateTime 类提供了字符串格式的时间。字符串形式的时间输出格式由 toString() 方法中的 format 参数列表决定，可⽤的参数列表如下：

1. 设计 UI 界面文件

放置一个 Label 控件，用来显示日期及时间，放置两个按钮：“开始” 和 “停止” 

在 "widget.h" 头文件中声明更新时间的槽函数

在 "widget.cpp" 文件中实现对应功能

实现效果如下：

6. 事件分发器

事件分发器概述：

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

事件分发器工作原理：

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

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

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

示例：

在 "widget.h" 头文件中声明鼠标点击事件和事件分发器

如下图示：

在 "widget.cpp" 文件中实现鼠标点击事件和拦截事件

7. 事件过滤器

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

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

如下图示：

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

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

示例：

（1）新建 Qt 项目

基类选择 QWidget，同时勾选 UI 界面文件，如下图示：

（2）设计 UI 文件

（3）在项目新添加⼀个类：MyLabel

先选中项目名称 QEvent，点击鼠标右键，选择 add new ... ，弹出如下对话框：

（4）选择：Choose ...

弹出如下界面：

（5）此时项目中会新添加以下两个文件

（6）在 UI 文件中选中 Label，右键 ——> 提升为...

（7）当点击 "提升为... " 之后，弹出对话框

（8）在 "mylabel.h" 中声明鼠标点击事件和事件分发器

（9）在 "mylabel.cpp" 文件中实现鼠标点击事件和事件分发器

（10）在 "widget.h" 头文件中声明事件过滤器函数

（11）在 "widget.cpp" 文件中实现事件过滤器的两个步骤

执行结果如下所示：

本篇完。

下一篇是Qt开发⑩Qt的文件操作+Qt多线程_使用示例。