一、事件处理基本流程

在Qt中，所有从QObject派生的类都能处理事件。事件处理的核心流程如下：

1. 事件入口函数：

   bool QObject::event(QEvent *e)
   

   • 参数e包含事件信息，通过e->type()获取事件类型

   • 返回值true表示事件已被处理，false表示未处理

2. 事件响应控制：

   e->accept();  // 接受事件，阻止传播
   e->ignore();  // 忽略事件，继续向父组件传播

3. 事件传播机制：

二、QWidget常用事件处理函数

QWidget预定义了针对特定事件类型的虚函数（均可重写）：

三、代码示例：自定义窗口事件处理

#include <QApplication>
#include <QWidget>
#include <QPainter>
#include <QMouseEvent>
#include <QDebug>// 自定义窗口类
class MyWindow : public QWidget {
public:MyWindow(QWidget *parent = nullptr) : QWidget(parent) {setWindowTitle("Qt事件处理示例");resize(400, 300);}protected:// 1. 绘制事件 - 绘制背景void paintEvent(QPaintEvent *event) override {QPainter painter(this);// 绘制渐变背景QLinearGradient gradient(0, 0, width(), height());gradient.setColorAt(0, Qt::cyan);gradient.setColorAt(1, Qt::blue);painter.fillRect(rect(), gradient);// 绘制文本painter.setPen(Qt::white);painter.setFont(QFont("Arial", 24));painter.drawText(rect(), Qt::AlignCenter, "点击窗口查看事件日志");}// 2. 鼠标点击事件void mousePressEvent(QMouseEvent *event) override {QString button;switch(event->button()) {case Qt::LeftButton: button = "左键"; break;case Qt::RightButton: button = "右键"; break;case Qt::MiddleButton: button = "中键"; break;default: button = "未知按键";}qDebug() << "鼠标点击: " << button << " 位置: (" << event->x() << "," << event->y() << ")";// 接受事件，阻止传播event->accept();}// 3. 键盘事件void keyPressEvent(QKeyEvent *event) override {qDebug() << "按键按下: " << event->text()<< " 键码: " << event->key();// ESC键关闭窗口if(event->key() == Qt::Key_Escape) {close();}}// 4. 窗口大小变化事件void resizeEvent(QResizeEvent *event) override {qDebug() << "窗口大小变化: " << event->oldSize() << " -> " << event->size();}
};int main(int argc, char *argv[]) {QApplication app(argc, argv);MyWindow window;window.show();return app.exec();
}

四、关键机制解析

• 事件处理优先级：

// 事件分发伪代码
bool QWidget::event(QEvent *e) {switch(e->type()) {case QEvent::MouseButtonPress:mousePressEvent(static_cast<QMouseEvent*>(e));return true;case QEvent::Paint:paintEvent(static_cast<QPaintEvent*>(e));return true;// ...其他事件类型default:return QObject::event(e);}
}

• 事件传播控制

void MyWidget::mousePressEvent(QMouseEvent *e) {if(shouldHandle(e)) {// 自定义处理逻辑e->accept();  // 事件终止传播} else {e->ignore();  // 事件传递给父组件}
}

• 自定义事件处理建议：
  • 优先重写特定事件处理函数（如mouseMoveEvent）
  • 需要处理特殊事件类型时重写event()函数
  • 在事件处理函数中避免耗时操作

五、运行效果说明

1. 窗口显示渐变背景和居中文本

2. 鼠标点击输出日志：

   鼠标点击: 左键 位置: (120,80)
   鼠标点击: 右键 位置: (200,150)
   

3. 键盘按键显示字符和键码

4. 调整窗口大小时输出尺寸变化

5. 按ESC键关闭窗口

最佳实践：对于需要精细控制事件流的场景（如游戏开发），可在event()函数中进行统一事件分发，结合event->type()和dynamic_cast实现多类型事件处理。

六、事件的接受与忽略

//!!! Qt5
// ---------- custombutton.h ----------
classCustomButton:publicQPushButton{Q_OBJECT
public:
CustomButton(QWidget *parent =0);
private:
voidonButtonCliecked();
};// ---------- custombutton.cpp ----------
CustomButton::CustomButton(QWidget *parent):QPushButton(parent){
connect(this,&CustomButton::clicked,this,&CustomButton::onButtonCliecked);
}voidCustomButton::onButtonCliecked(){
qDebug()<<"You clicked this!";
}// ---------- main.cpp ----------
intmain(int argc,char*argv[]){QApplication a(argc, argv);CustomButton btn;btn.setText("This is a Button!");btn.show();
return a.exec();
}

这段代码的运行结果是：点击按钮，会在控制台打印出"You clicked this!"字符串。

重写事件函数

下面我们向CustomButton类添加一个事件函数：

// CustomButton ...
protected:
voidmousePressEvent(QMouseEvent *event);
...// ---------- custombutton.cpp ----------
...
voidCustomButton::mousePressEvent(QMouseEvent *event)
{if(event->button()== Qt::LeftButton){qDebug()<<"left";}else{QPushButton::mousePressEvent(event);}
}

重写mousePressEvent()函数后：

1. 当鼠标按下的是左键，打印"left"字符串

2. 否则调用父类的同名函数

3. 此时"You clicked this!"字符串不再出现

重要注意事项

1. 事件传递机制：

   • 当重写事件回调函数时，必须注意是否需要调用父类的同名函数

   • 如果完全覆盖父类函数，可能导致原有功能失效（如clicked()信号不会发出）

2. accept()和ignore()函数：

   • accept()：告诉Qt这个类想要处理这个事件

   • ignore()：告诉Qt这个类不想要处理这个事件

   • 可以使用isAccepted()查询事件是否已被接收

3. 默认行为：

   • 事件对象默认是accept的

   • QWidget的默认实现是调用ignore()

   • 不调用父类实现等同于接受事件

   • 调用父类实现等同于忽略事件

事件传播示例

classCustomButton:publicQPushButton{Q_OBJECT
public:CustomButton(QWidget *parent):QPushButton(parent){}
protected:voidmousePressEvent(QMouseEvent *event){qDebug()<<"CustomButton";}
};classCustomButtonEx:publicCustomButton{Q_OBJECT
public:CustomButtonEx(QWidget *parent):CustomButton(parent){}
protected:voidmousePressEvent(QMouseEvent *event){qDebug()<<"CustomButtonEx";}
};classCustomWidget:publicQWidget{Q_OBJECT
public:CustomWidget(QWidget *parent):QWidget(parent){}
protected:voidmousePressEvent(QMouseEvent *event){qDebug()<<"CustomWidget";}
};classMainWindow:publicQMainWindow{Q_OBJECT
public:
MainWindow(QWidget *parent =0):QMainWindow(parent){CustomWidget *widget =newCustomWidget(this);CustomButton *cbex =newCustomButton(widget);cbex->setText(tr("CustomButton"));CustomButtonEx *cb =newCustomButtonEx(widget);cb->setText(tr("CustomButtonEx"));QVBoxLayout *widgetLayout =newQVBoxLayout(widget);widgetLayout->addWidget(cbex);widgetLayout->addWidget(cb);this->setCentralWidget(widget);
}
protected:voidmousePressEvent(QMouseEvent *event){qDebug()<<"MainWindow";}
};

测试结果：

1. 默认情况下输出"CustomButtonEx"
2. 添加event->ignore()后输出"CustomButtonEx CustomWidget"
3. 在CustomWidget中添加QWidget::mousePressEvent(event)后输出"CustomButtonEx CustomWidget MainWindow"

特殊应用场景：窗口关闭事件

//!!! Qt5
...
textEdit =newQTextEdit(this);
setCentralWidget(textEdit);
connect(textEdit,&QTextEdit::textChanged,[=](){this->setWindowModified(true);});
setWindowTitle("TextPad [*]");
...voidMainWindow::closeEvent(QCloseEvent *event){if(isWindowModified()){bool exit =QMessageBox::question(this,tr("Quit"),tr("Are you sure to quit this application?"),QMessageBox::Yes | QMessageBox::No,QMessageBox::No)== QMessageBox::Yes;if(exit){event->accept();}else{event->ignore();}}else{event->accept();}
}

关键点：

1. setWindowTitle()使用"[]"语法表示修改状态
2. 重写closeEvent()处理关闭事件
3. accept()会关闭窗口，ignore()会阻止关闭