Qt事件常用类，QLabel的QFrame交互

一.QT的事件系统概述

1.QEvent类是所有事件的基类

事件一个一个处理，所以事件处理不能死循环

负责处理应用程序中所有的用户交互、系统通知、内部状态变化等行为

2. 最顶层：QEvent（所有事件的祖宗）

2.1 角色：

这是所有事件类的基类

2.2 含义：

在 Qt 中，“事件” 不仅仅是一个信号，它是一个对象。所有具体的事件（如鼠标点击、窗口关闭）都继承自这个类

2.3 关键方法：

图上方的文字提到了 type() 函数，这是 QEvent 提供的核心方法，用于判断这个事件具体是哪一种（比如：是鼠标事件，还是键盘事件）

type() 本身可以直接调用，不需要先知道事件类型

3. 中间层：基础事件分类（大类）

从 QEvent 直接派生出来的类，代表了事件的大分类：

3.1 QInputEvent：输入事件的基类

所有来自用户硬件（鼠标、键盘、触摸屏）的输入操作，都属于这一支

3.2 QMouseEvent：鼠标事件

图中它属于 QSinglePointEvent（单点事件），代表鼠标点击、移动、释放等操作

3.3 QKeyEvent：键盘事件

属于 QInputEvent，代表按键按下、松开

3.4 QPaintEvent：绘制事件

当窗口需要重绘时（比如移动窗口、拉大窗口），就会产生这个事件

3.5 QCloseEvent：关闭事件

点击窗口右上角的叉号关闭窗口时产生

3.6 QTimerEvent：定时器事件

定时触发

3.7 QResizeEvent：大小变化事件

窗口缩放时触发。

4. 最底层：具体的交互事件的类（细分）

图中最下方展开的部分，是针对特定交互的详细事件类型：

QSinglePointEvent：它是 QPointerEvent 的子类，专门处理单点触摸或鼠标操作。

QHoverEvent：悬停事件。鼠标停留在控件上但没按下时触发。

QWheelEvent：滚轮事件。鼠标滚轮滚动。

QTouchEvent：触摸事件。针对触摸屏设备（手机、平板）。

拖拽相关（QDrag...Event）：包括 QDragEnterEvent（进入）、QDragMoveEvent（移动）、QDropEvent（放下），这是一整套拖放操作的事件流

二.QLabel的QFrame显示设置

1. 控件的继承关系

Qt 里的控件有明确的继承关系

QLabel（文本 / 图片标签）是从 QFrame（框架控件）继承来的 —— 就像 “苹果” 继承了 “水果” 的所有特性，QLabel 也继承了 QFrame 管 “边框、阴影” 的所有能力

1.1 QFrame 的定位：

专门管理控件的 “框架外观”，比如有没有边框、边框是凸起还是凹陷、边框线多粗

1.2 QLabel 的定位：

主要负责显示文本 / 图片，但因为继承了 QFrame，所以能直接用 QFrame 的样式能力

1.3 实际应用场景：

比如你做一个 “状态提示标签”
正常状态：无框架，只显示文字；
警告状态：加红色凹陷边框，让提示更醒目；
成功状态：加绿色凸起边框，视觉上更友好。
本质是通过框架样式让标签的视觉效果匹配业务场景，不用额外做图片 / 控件

可以把 QLabel 想象成一个 “带文字的相框”，这些属性就是给相框做定制：相框形状，相框阴影，边框线宽
头文件用QLabel 或 QFrame

QFrame::Panel 和 QFrame::Plain 是 QFrame 类内部定义的枚举常量

Panel 是 框架形状（Shape）枚举值，代表 “面板样式” 的边框；
Plain 是 框架阴影（Shadow）枚举值，代表 “平面无立体感” 的边框效果