C++，Qt事件处理机制编程开发练习全解析，23000字解析！！

你提供的代码是一个 Qt C++ 程序的主窗口类 Widget 的实现文件，即 widget.cpp。这个类继承自 QWidget，是 Qt 中最基本的界面组件之一。

include "widget.h"
#include "ui_widget.h"
#include <QDebug>
#include <QMessageBox>
#include <QWheelEvent>
Widget::Widget(QWidget *parent)
: QWidget(parent)
, ui(new Ui::Widget)
{
ui->setupUi(this);
}
Widget::~Widget()
{
delete ui;
}
void Widget::enterEvent(QEvent *event)
{
qDebug() << "mouse enter";
}
void Widget::leaveEvent(QEvent *event)
{
qDebug() << "mouse leave";
}
void Widget::wheelEvent(QWheelEvent *event)
{
qDebug() << event->angleDelta();
}
void Widget::closeEvent(QCloseEvent *event)
{
int ret = QMessageBox::warning(this, tr("My Application"),
tr("close the window\n"
"Do you want to close the window?"),
QMessageBox::Ok | QMessageBox::No
);
switch(ret){
case QMessageBox::Ok:
event->accept();
break;
case QMessageBox::No:
event->ignore();
break;
}
}
void Widget::resizeEvent(QResizeEvent *event)
{
qDebug() << "oldSize:" << event->oldSize()
<< "newSize:" << event->size();}
void Widget::on_pushButton_clicked()
{
}

🧱 一、代码结构总览

这段代码实现了以下功能：

• 构造函数和析构函数；
• 重写了一些重要的事件处理函数（如鼠标进入/离开、滚轮、关闭、调整大小）；
• 实现了一个按钮点击槽函数（目前为空）；
• 使用了 Qt 的信号与槽机制来响应用户交互；
• 使用了 Qt 提供的调试输出工具 qDebug() 和对话框控件 QMessageBox；

📝 二、逐行注释 + 功能详解

#include "widget.h"
#include "ui_widget.h"      // 自动生成的 UI 头文件
#include <QDebug>           // 调试输出工具
#include <QMessageBox>      // 弹窗对话框
#include <QWheelEvent>      // 鼠标滚轮事件

✅ 构造函数：初始化界面

Widget::Widget(QWidget *parent): QWidget(parent)       // 调用父类构造函数, ui(new Ui::Widget)    // 创建 UI 对象
{ui->setupUi(this);      // 初始化界面布局和控件
}

• 这是主窗口的构造函数；
• ui->setupUi(this) 是关键，它将 .ui 文件中设计好的界面加载到当前窗口上；
• 所有通过 Qt Designer 添加的控件都会在这里被创建并绑定；

✅ 析构函数：释放资源

Widget::~Widget()
{delete ui;              // 删除 UI 对象，防止内存泄漏
}

• 在窗口销毁时自动调用；
• 用于释放 ui 指针指向的对象内存；

🖱️ 三、事件响应函数

1. 鼠标进入控件区域

void Widget::enterEvent(QEvent *event)
{qDebug() << "mouse enter";
}

• 当鼠标进入窗口区域时触发；
• 输出 "mouse enter" 到控制台；
• 可用于高亮控件或播放动画；

2. 鼠标离开控件区域

void Widget::leaveEvent(QEvent *event)
{qDebug() << "mouse leave";
}

• 鼠标移出窗口区域时触发；
• 输出 "mouse leave"；
• 常用于取消悬停效果；

3. 鼠标滚轮事件

void Widget::wheelEvent(QWheelEvent *event)
{qDebug() << event->angleDelta();
}

• 鼠标滚轮滚动时触发；
• event->angleDelta() 返回一个 QPoint，表示滚轮滚动的方向和幅度；
  • (0, 120) 表示向上滚动；
  • (0, -120) 表示向下滚动；
• 可用于缩放、翻页等功能；

4. 窗口关闭事件

void Widget::closeEvent(QCloseEvent *event)
{int ret = QMessageBox::warning(this, tr("My Application"),tr("close the window\n""Do you want to close the window?"),QMessageBox::Ok | QMessageBox::No);switch(ret){case QMessageBox::Ok:event->accept();    // 接受关闭请求break;case QMessageBox::No:event->ignore();    // 忽略关闭请求break;}
}

• 用户点击关闭按钮时弹出确认对话框；
• 如果用户选择“确定”，则允许关闭；
• 否则阻止关闭；
• 这个功能常用于防止误操作关闭程序；

5. 窗口大小改变事件

void Widget::resizeEvent(QResizeEvent *event)
{qDebug() << "oldSize:" << event->oldSize()<< "newSize:" << event->size();
}

• 窗口尺寸发生变化时触发；
• 输出旧尺寸和新尺寸；
• 可用于动态调整布局或刷新内容；

🔘 四、按钮点击槽函数（未实现）

void Widget::on_pushButton_clicked()
{
}

• 这是一个按钮点击事件的槽函数；
• 函数名格式为 on_<控件名>_clicked()，这是 Qt 自动连接的命名规则；
• 目前为空，需要你自己添加响应逻辑；
• 示例：点击后弹出提示框、切换页面、打开文件等；

📘 五、技术点总结

🧩 六、可扩展建议

你可以在这个基础上做如下扩展：

1. 完善按钮点击功能

void Widget::on_pushButton_clicked()
{QMessageBox::information(this, "提示", "按钮被点击了！");
}

2. 更换窗口标题和图标

setWindowTitle("我的第一个 Qt 程序");
setWindowIcon(QIcon(":/icon/app_icon.png"));

3. 添加样式表美化界面

this->setStyleSheet("background-color: #f0f0f0;");
ui->pushButton->setStyleSheet("background-color: #4CAF50; color: white; border-radius: 5px;");

4. 添加菜单栏、工具栏、状态栏

可以通过 Qt Designer 或手动代码添加这些标准控件；

📦 七、项目结构建议（完整版）

project/
├── main.cpp            // 程序入口
├── widget.h/cpp        // 主窗口类定义和实现
├── ui_widget.h         // 自动生成的 UI 头文件
├── Widget.ui           // Qt Designer 设计文件
├── mybutton.h/cpp      // 自定义按钮类（如有）
├── resources.qrc       // 资源文件（图片、图标等）
└── .pro                // 项目配置文件

📚 八、延伸学习方向

如果你希望我帮你：

• 给 on_pushButton_clicked() 添加具体功能；
• 教你如何使用 Qt Designer 设计更复杂的界面；
• 或者教你如何将这个项目打包成可执行文件； 欢迎继续提问 😊

#ifndef MYBUTTON_H
#define MYBUTTON_H
#include <QWidget>
class MyButton : public QWidget
{
Q_OBJECT
private:
QPixmap pic;
public:
explicit MyButton(QWidget *parent = nullptr);
protected:
void mousePressEvent(QMouseEvent *event) override;
void leaveEvent(QEvent *event) override;
void enterEvent(QEvent *event) override;
void paintEvent(QPaintEvent *event) override;
signals:
void clicked();
};
#endif // MYBUTTON_H

#ifndef MYBUTTON_H
#define MYBUTTON_H

#include <QWidget>

class MyButton : public QWidget
{Q_OBJECT

private:QPixmap pic;

explicit MyButton(QWidget *parent = nullptr);

protected:void mousePressEvent(QMouseEvent *event) override;void leaveEvent(QEvent *event) override;void enterEvent(QEvent *event) override;void paintEvent(QPaintEvent *event) override;

signals:void clicked();

connect(myBtn, &MyButton::clicked, this, &MyClass::handleButtonClick);

#ifndef MYBUTTON_H
#define MYBUTTON_H#include <QWidget>        // 基类头文件
#include <QPixmap>        // 用于加载和显示图片// 自定义按钮类，继承自 QWidget
class MyButton : public QWidget
{Q_OBJECT      // 启用信号与槽机制public:// 构造函数explicit MyButton(QWidget *parent = nullptr);protected:// 鼠标按下事件：用于检测点击void mousePressEvent(QMouseEvent *event) override;// 鼠标离开按钮区域时触发void leaveEvent(QEvent *event) override;// 鼠标进入按钮区域时触发void enterEvent(QEvent *event) override;// 绘图事件：绘制按钮图像void paintEvent(QPaintEvent *event) override;signals:// 点击信号：当按钮被点击时发出void clicked();private:QPixmap pic;  // 按钮使用的图片资源
};#endif // MYBUTTON_H

QPixmap normalPic, hoverPic, pressedPic;

#include "mybutton.h"
#include <QPainter>
MyButton::MyButton(QWidget *parent) : QWidget(parent)
{
pic.load(":/o1.png");
setFixedSize(pic.size());
update();
}
void MyButton::mousePressEvent(QMouseEvent *event)
{
pic.load(":/o3.png");
update();emit clicked();
}
void MyButton::leaveEvent(QEvent *event)
{
pic.load(":/o1.png");
update();
}
void MyButton::enterEvent(QEvent *event)
{
pic.load(":/o2.png");
update();
}
void MyButton::paintEvent(QPaintEvent *event)
{
QPainter painter(this);
painter.drawPixmap(rect(),pic);
}

#include "mybutton.h"
#include <QPainter>

MyButton::MyButton(QWidget *parent) : QWidget(parent)
{pic.load(":/o1.png");          // 加载默认状态图片setFixedSize(pic.size());      // 设置按钮尺寸为图片尺寸update();                      // 触发重绘
}

void MyButton::mousePressEvent(QMouseEvent *event)
{pic.load(":/o3.png");     // 加载按下状态图片update();                  // 重绘按钮emit clicked();            // 发出点击信号
}

void MyButton::leaveEvent(QEvent *event)
{pic.load(":/o1.png");     // 加载默认状态图片update();                  // 重绘按钮
}

void MyButton::enterEvent(QEvent *event)
{pic.load(":/o2.png");     // 加载悬停状态图片update();                  // 重绘按钮
}

void MyButton::paintEvent(QPaintEvent *event)
{QPainter painter(this);           // 创建绘图对象painter.drawPixmap(rect(), pic);  // 在按钮区域内绘制当前图片
}

#include "mybutton.h"
#include <QPainter>        // 用于绘制图形界面// 构造函数：初始化按钮的图片、大小，并触发重绘
MyButton::MyButton(QWidget *parent) : QWidget(parent)
{pic.load(":/o1.png");         // 默认状态图片setFixedSize(pic.size());     // 设置按钮尺寸为图片尺寸update();                     // 请求重绘
}// 鼠标按下事件：切换为“按下”状态图片，并发出 clicked() 信号
void MyButton::mousePressEvent(QMouseEvent *event)
{pic.load(":/o3.png");   // 按下状态图片update();               // 触发重绘emit clicked();         // 发出点击信号
}// 鼠标离开事件：恢复为“默认”状态图片
void MyButton::leaveEvent(QEvent *event)
{pic.load(":/o1.png");   // 默认状态图片update();               // 触发重绘
}// 鼠标进入事件：切换为“悬停”状态图片
void MyButton::enterEvent(QEvent *event)
{pic.load(":/o2.png");   // 悬停状态图片update();               // 触发重绘
}// 绘制事件：将当前图片绘制到控件上
void MyButton::paintEvent(QPaintEvent *event)
{QPainter painter(this);              // 创建绘图上下文painter.drawPixmap(rect(), pic);     // 绘制图片到整个控件区域
}

MyButton *btn = new MyButton(this);
connect(btn, &MyButton::clicked, this, &MyClass::onButtonClick);

#include "widget.h"
#include "ui_widget.h"
#include "mybutton.h"
#include <QDebug>
Widget::Widget(QWidget *parent)
: QWidget(parent)
, ui(new Ui::Widget)
{
ui->setupUi(this);
connect(ui->mybtn,&MyButton::clicked,[=](){
qDebug() << "myButton is clicked !";
});
}
Widget::~Widget()
{
delete ui;
}

#include "widget.h"
#include "ui_widget.h"
#include "mybutton.h" // 包含自定义按钮类的头文件
#include <QDebug> // 提供调试输出功能// 构造函数：初始化界面并设置信号与槽连接
Widget::Widget(QWidget *parent): QWidget(parent), ui(new Ui::Widget)
{ui->setupUi(this); // 根据.ui文件配置初始化界面// 连接自定义按钮的clicked信号到Lambda表达式connect(ui->mybtn, &MyButton::clicked, [=](){qDebug() << "myButton is clicked !"; // 当按钮被点击时输出调试信息});
}// 析构函数：释放资源
Widget::~Widget()
{delete ui; // 删除UI对象以避免内存泄漏
}

#ifndef MYTEXTEDIT_H
#define MYTEXTEDIT_H
#include <QTextEdit>
class MyTextEdit : public QTextEdit
{
public:
MyTextEdit(QWidget *parent);
protected:
void wheelEvent(QWheelEvent *e) override;
void keyPressEvent(QKeyEvent *e) override;
void keyReleaseEvent(QKeyEvent *e) override;
private:
bool ctrlKeyPressed = 0;
};
#endif // MYTEXTEDIT_H

#ifndef MYTEXTEDIT_H
#define MYTEXTEDIT_H// 引入基类头文件
#include <QTextEdit>// 自定义文本编辑控件类
class MyTextEdit : public QTextEdit
{Q_OBJECT  // 启用信号与槽机制（虽然本例中未使用）public:// 构造函数MyTextEdit(QWidget *parent);protected:// 滚轮事件：当鼠标滚轮滚动时触发void wheelEvent(QWheelEvent *e) override;// 键盘按键按下事件void keyPressEvent(QKeyEvent *e) override;// 键盘按键释放事件void keyReleaseEvent(QKeyEvent *e) override;private:// 用于记录 Ctrl 键是否被按下bool ctrlKeyPressed = false;
};#endif // MYTEXTEDIT_H

#ifndef MYTEXTEDIT_H
#define MYTEXTEDIT_H
...
#endif // MYTEXTEDIT_H

#include <QTextEdit>

class MyTextEdit : public QTextEdit
{Q_OBJECT

MyTextEdit(QWidget *parent);

bool ctrlKeyPressed = false;

void MyTextEdit::wheelEvent(QWheelEvent *event)
{if (ctrlKeyPressed) {int delta = event->angleDelta().y(); // 获取滚轮方向QFont font = this->font();if (delta > 0) {font.setPointSize(font.pointSize() + 1); // 放大} else {font.setPointSize(font.pointSize() - 1); // 缩小}this->setFont(font);} else {QTextEdit::wheelEvent(event); // 默认滚轮行为（上下滚动）}
}

void MyTextEdit::keyPressEvent(QKeyEvent *event)
{if (event->modifiers() & Qt::ControlModifier) {ctrlKeyPressed = true;if (event->key() == Qt::Key_S) {qDebug() << "Ctrl + S pressed, save content...";}}QTextEdit::keyPressEvent(event); // 确保原始事件继续处理
}

void MyTextEdit::keyReleaseEvent(QKeyEvent *event)
{if (!(event->modifiers() & Qt::ControlModifier)) {ctrlKeyPressed = false;}QTextEdit::keyReleaseEvent(event);
}

#include "mytextedit.h"
#include <QWheelEvent>
#include <QDebug>
MyTextEdit::MyTextEdit(QWidget *parent) : QTextEdit(parent)
{
}
void MyTextEdit::wheelEvent(QWheelEvent *e)
{
//qDebug() << e->angleDelta().y();
if(ctrlKeyPressed == 1){
if(e->angleDelta().y() > 0){
zoomIn();
}else if(e->angleDelta().y() < 0){
zoomOut();
}
e->accept();
}else{
QTextEdit::wheelEvent(e);
}
}
void MyTextEdit::keyPressEvent(QKeyEvent *e)
{
if(e->key() == Qt::Key_Control){
// qDebug() << "ctrl Pressed";
ctrlKeyPressed = 1;
}
QTextEdit::keyPressEvent(e);
}
void MyTextEdit::keyReleaseEvent(QKeyEvent *e)
{
if(e->key() == Qt::Key_Control){
// qDebug() << "ctrl Release";
ctrlKeyPressed = 0;
}
QTextEdit::keyPressEvent(e);
}

#include "mytextedit.h"
#include <QWheelEvent>
#include <QDebug>// 构造函数：直接调用基类 QTextEdit 的构造函数
MyTextEdit::MyTextEdit(QWidget *parent) : QTextEdit(parent)
{// 可以在这里初始化资源或设置默认属性（当前为空）
}// 滚轮事件：当鼠标滚轮滚动时触发
void MyTextEdit::wheelEvent(QWheelEvent *e)
{// 如果 Ctrl 键被按下，则进行缩放操作if (ctrlKeyPressed == 1){// 判断滚轮方向if (e->angleDelta().y() > 0){zoomIn();  // 向上滚动：放大字体}else if (e->angleDelta().y() < 0){zoomOut(); // 向下滚动：缩小字体}e->accept(); // 接受事件，表示已处理}else{// 如果没有按 Ctrl 键，则执行 QTextEdit 默认的滚轮行为（上下滚动内容）QTextEdit::wheelEvent(e);}
}// 键盘按键按下事件：用于检测 Ctrl 键是否被按下
void MyTextEdit::keyPressEvent(QKeyEvent *e)
{// 如果用户按下了 Ctrl 键if (e->key() == Qt::Key_Control){ctrlKeyPressed = 1;  // 设置 Ctrl 键状态为“按下”}// 调用父类方法，保持原有键盘输入功能（如输入文字等）QTextEdit::keyPressEvent(e);
}// 键盘按键释放事件：用于检测 Ctrl 键是否被松开
void MyTextEdit::keyReleaseEvent(QKeyEvent *e)
{// 如果用户松开了 Ctrl 键if (e->key() == Qt::Key_Control){ctrlKeyPressed = 0;  // 设置 Ctrl 键状态为“未按下”}// 调用父类方法，保持原有键盘输入功能QTextEdit::keyPressEvent(e);
}

MyTextEdit::MyTextEdit(QWidget *parent) : QTextEdit(parent)
{
}

if(ctrlKeyPressed == 1){...
}else{QTextEdit::wheelEvent(e);
}

if(e->key() == Qt::Key_Control){ctrlKeyPressed = 1;
}
QTextEdit::keyPressEvent(e);

if(e->key() == Qt::Key_Control){ctrlKeyPressed = 0;
}
QTextEdit::keyPressEvent(e);

QTextEdit::keyPressEvent(e); // 错误！应该是 keyReleaseEvent

QTextEdit::keyReleaseEvent(e);

ui->textEdit->installEventFilter(this); // 给textEdit安装了事件过滤器,为滚轮字体做准备

bool Widget::eventFilter(QObject *watched, QEvent *event)
{
if (event->type() == QEvent::Wheel) {
QWheelEvent *wheelEvent = dynamic_cast<QWheelEvent *>(event);
//检查键盘的CTRL是否被按下
if (QGuiApplication::keyboardModifiers() & Qt::ControlModifier){
if (wheelEvent->angleDelta().y() > 0) {
zoomInText(); // 滚轮向上滚动} else {
zoomOutText(); // 滚轮向下滚动
}
}
return true;//表示事件已被处理
}
return QWidget::eventFilter(watched, event);
}
void Widget::zoomInText()
{
// 放大字体
QFont font = ui->textEdit->font();
font.setPointSize(font.pointSize() + 1);
ui->textEdit->setFont(font);
}
void Widget::zoomOutText()
{
// 缩小字体
QFont font = ui->textEdit->font();
font.setPointSize(font.pointSize() - 1);
ui->textEdit->setFont(font);
}

bool Widget::eventFilter(QObject *watched, QEvent *event)
{// 判断事件类型是否为鼠标滚轮事件if (event->type() == QEvent::Wheel){// 将事件转换为 QWheelEvent 类型QWheelEvent *wheelEvent = dynamic_cast<QWheelEvent *>(event);// 检查当前是否有按下 Ctrl 键if (QGuiApplication::keyboardModifiers() & Qt::ControlModifier){// 如果滚轮向上滚动if (wheelEvent->angleDelta().y() > 0){zoomInText(); // 放大字体}else{zoomOutText(); // 缩小字体}return true; // 表示事件已被处理，不再传递给其他对象}}// 调用父类的 eventFilter 方法处理未被我们处理的事件return QWidget::eventFilter(watched, event);
}// 放大字体函数
void Widget::zoomInText()
{QFont font = ui->textEdit->font();font.setPointSize(font.pointSize() + 1); // 字号加1ui->textEdit->setFont(font);              // 应用新字体
}// 缩小字体函数
void Widget::zoomOutText()
{QFont font = ui->textEdit->font();font.setPointSize(font.pointSize() - 1); // 字号减1ui->textEdit->setFont(font);              // 应用新字体
}

bool Widget::eventFilter(QObject *watched, QEvent *event)

if (event->type() == QEvent::Wheel)

QWheelEvent *wheelEvent = dynamic_cast<QWheelEvent *>(event);

if (QGuiApplication::keyboardModifiers() & Qt::ControlModifier)

if (wheelEvent->angleDelta().y() > 0) {zoomInText(); // 向上滚动，放大字体
} else {zoomOutText(); // 向下滚动，缩小字体
}

return true;

return QWidget::eventFilter(watched, event);

void Widget::zoomInText()
{QFont font = ui->textEdit->font();font.setPointSize(font.pointSize() + 1);ui->textEdit->setFont(font);
}void Widget::zoomOutText()
{QFont font = ui->textEdit->font();font.setPointSize(font.pointSize() - 1);ui->textEdit->setFont(font);
}