installeventfilter —— 一個事件過濾器

installeventfilter作為Qt GUI編程中的一個重要組成部分，在Qt很多實際開發項目中經常被使用。installeventfilter的作用是為對象安裝一個事件過濾器，從而可以截獲對象的事件。在下面的文章中，我們將從多個方面來詳細探討installeventfilter的作用、使用方法和可能的異常情況。

一、installeventfilter無法

1、安裝事件過濾器失敗
如果對象的繼承鏈中沒有eventFilter函數實現，則調用installEventFilter()函數時會失敗，應該確保對象中eventFilter函數的重載實現。

    class CustomWidget : public QWidget
    {
        Q_OBJECT
    
    public:
        explicit CustomWidget(QWidget *parent = nullptr);
    
    protected:
        bool eventFilter(QObject *obj, QEvent *event) override;
    }
    
    CustomWidget::CustomWidget(QWidget *parent)
        : QWidget(parent)
    {
        QWidget *button = new QPushButton();
        button->installEventFilter(this); // 此處將控制項button的事件過濾器設置為CustomWidget，需確保CustomWidget實現了eventFilter函數
    }
    
    bool CustomWidget::eventFilter(QObject *obj, QEvent *event)
    {
        Q_UNUSED(obj);
        if (event->type() == QEvent::MouseMove) {
            // 在此處理移動事件
            return true;
        }
        return QWidget::eventFilter(obj, event);
    }

2、事件過濾器重複設置
使用一個對象為另一個對象安裝一個事件過濾器時，應該確保只能安裝一次。因為重複安裝會造成事件被多次過濾，從而產生意料之外的結果。

    QWidget *button = new QPushButton();
    if (!button->parent()) {
        // 檢查button是否已有父對象
        CustomWidget *widget = new CustomWidget();
        button->installEventFilter(widget);
    }

二、installeventfilter 異常退出

1、事件過濾器卸載失敗
如果對象已經被銷毀或事件過濾器並未被正確卸載，則安裝事件過濾器會產生異常。應該在Widget被銷毀前手動卸載事件過濾器。

    CustomWidget *widget = new CustomWidget();
    QWidget *button = new QPushButton();
    button->installEventFilter(widget);
    // 在程序退出前，手動卸載事件過濾器
    button->removeEventFilter(widget); 

2、過濾的事件類型錯誤
在事件過濾器中，只能處理特定類型的事件。如果過濾事件類型錯誤，將會導致程序異常退出。應該在實現過濾器函數時，先判斷事件類型是否匹配。

    bool CustomWidget::eventFilter(QObject *obj, QEvent *event)
    {
        if (event->type() == QEvent::KeyPress && obj == button) { // 該事件過濾器處理某個push button對象的按鍵事件
            QKeyEvent *keyEvent = static_cast(event);
            if (keyEvent->key() == Qt::Key_Delete) { // 只處理某個按鍵事件
                // 在此處理刪除事件
                return true;
            }
        }
        return QWidget::eventFilter(obj, event);
    }

三、installeventfilter(this)選取

1、多個對象使用同一個事件過濾器
在處理多個對象的相同事件時，可以為這些對象安裝同一個事件過濾器。這時可以使用this作為事件過濾器，因為在對象內部，this實際上就是這個對象的地址。這樣可以簡化代碼，提高程序效率。

    QLineEdit *line1 = new QLineEdit();
    QLineEdit *line2 = new QLineEdit();
    QLineEdit *line3 = new QLineEdit();
    // 三個QLineEdit共用一個事件過濾器
    line1->installEventFilter(this);
    line2->installEventFilter(this);
    line3->installEventFilter(this);
    
    bool CustomWidget::eventFilter(QObject *obj, QEvent *event)
    {
        if (event->type() == QEvent::FocusIn && obj == line1) { // 該事件過濾器處理多個LineEdit對象的獲取焦點事件
            // 在此處理焦點事件
            return QWidget::eventFilter(obj, event);
        } else if (event->type() == QEvent::FocusIn && obj == line2) {
            // 在此處理焦點事件
            return QWidget::eventFilter(obj, event);
        } else if (event->type() == QEvent::FocusIn && obj == line3) {
            // 在此處理焦點事件
            return QWidget::eventFilter(obj, event);
        }
        return QWidget::eventFilter(obj, event);
    }

2、給子對象安裝事件過濾器
在父對象中，給所有子對象安裝同一個事件過濾器也可以使用this作為事件過濾器。這樣可以減少代碼量，提高程序效率。

    CustomWidget::CustomWidget(QWidget *parent)
        : QWidget(parent)
    {
        QLineEdit *line1 = new QLineEdit();
        QLineEdit *line2 = new QLineEdit();
        QLineEdit *line3 = new QLineEdit();
        // 所有LineEdit共用一個事件過濾器
        line1->installEventFilter(this);
        line2->installEventFilter(this);
        line3->installEventFilter(this);
    }   

四、installeventfilter的使用示例

    // 為一個QLabel安裝事件過濾器，當該QLabel滑鼠移動時，在狀態欄顯示該位置的坐標
    class CustomWidget : public QWidget
    {
        Q_OBJECT
    
    public:
        explicit CustomWidget(QWidget *parent = nullptr);
    
    protected:
        bool eventFilter(QObject *obj, QEvent *event) override;
    
    private:
        QLabel *label;
        QStatusBar *statusBar;
    };
    
    CustomWidget::CustomWidget(QWidget *parent)
        : QWidget(parent)
    {
        label = new QLabel("Label");
        statusBar = new QStatusBar();
        QHBoxLayout *layout = new QHBoxLayout();
        layout->addWidget(label);
        setLayout(layout);
        setStatusBar(statusBar);
    
        label->installEventFilter(this); // 為label安裝事件過濾器
    }
    
    bool CustomWidget::eventFilter(QObject *obj, QEvent *event)
    {
        if (obj == label && event->type() == QEvent::MouseMove) { // 該事件過濾器處理QLabel滑鼠移動事件
            QMouseEvent *mouseEvent = static_cast(event);
            QString status = QString("坐標：%1,%2").arg(mouseEvent->pos().x()).arg(mouseEvent->pos().y());
            statusBar->showMessage(status);
        }
        return QWidget::eventFilter(obj, event);
    }