Qt 學習之路 (20)：事件接受與忽略機制深度解析

前言

Qt 事件傳遞呈鏈狀結構。本篇深入解析 accept()/ignore()、父類調用與事件傳播的關係、何時必須顯式使用接受/忽略、關閉事件的特殊處理。

一、事件傳播鏈與兩種「忽略」方式

子類重寫事件處理函數時，若不處理某事件，有兩種做法：

方式 A：呼叫父類實現（推薦）

void MyLabel::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        // 處理左鍵
    } else {
        QLabel::mousePressEvent(event);  // 傳遞給父類
    }
}

方式 B：顯式 ignore()

void MyLabel::mousePressEvent(QMouseEvent *event) {
    if (event->button() == Qt::LeftButton) {
        // 處理左鍵
        event->accept();  // 可選，預設即接受
    } else {
        event->ignore();  // 標記忽略，Qt 繼續尋找接收者
    }
}

二、為何推薦方式 A？

查看 QWidget::mousePressEvent() 源碼：

void QWidget::mousePressEvent(QMouseEvent *event) {
    event->ignore();  // 預設忽略，繼續向父組件傳播
    if (windowType() == Qt::Popup) { ... }  // 彈出視窗特殊邏輯
}

• 父類實現可能包含必要邏輯（如 Popup 關閉處理）
• 直接 ignore() 會跳過父類邏輯，潛在風險
• 呼叫父類實現 = 執行父類邏輯 + 父類內部再 ignore() 繼續傳播，**雙贏**

三、必須使用 accept()/ignore() 的場景：關閉事件

closeEvent() 無父類預設實現可呼叫，必須顯式決定：

void MainWindow::closeEvent(QCloseEvent *event) {
    if (confirmToClose()) {
        event->accept();  // 允許關閉，事件傳播結束
    } else {
        event->ignore();  // 拒絕關閉，視窗保持開啟
    }
}

bool MainWindow::confirmToClose() {
    return QMessageBox::question(this, "Quit",
        "Are you sure to quit?",
        QMessageBox::Yes | QMessageBox::No,
        QMessageBox::No) == QMessageBox::Yes;
}

四、事件接受狀態查詢

• event->isAccepted()：檢查事件當前是否已被接受
• 事件處理函數中可隨時查詢，決策後續邏輯

五、總結：事件控制五層次（控制權遞增）

1. 重寫具體事件處理函數（mousePressEvent 等）
2. 重寫 QObject::event() 統一分發
3. 為單一組件安裝事件過濾器
4. 為 QApplication 安裝全域事件過濾器
5. 重寫 QCoreApplication::notify() 終極攔截

本文出自「豆子空間」博客。