一、事件處理基本流程

在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()會阻止關閉