引言

個人認為，事件機制是Qt最難以理解且最為精妙的一部分。事件主要分為兩種：

1. 在與用戶交互時發(fā)生。比如按下鼠標（mousePressEvent），敲擊鍵盤（keyPressEvent）等。

2. 系統(tǒng)自動發(fā)生，比如計時器事件（timerEvent）等。

在發(fā)生事件時（比如說上面說的按下鼠標），就會產(chǎn)生一個QEvent對象（這里是QMouseEvent，為QEvent的子類），這個QEvent對象會傳給當前組件的event函數(shù)。如果當前組件沒有安裝事件過濾器（這個后面會提到），則會被event函數(shù)發(fā)放到相應的xxxEvent函數(shù)中（這里是mousePressEvent函數(shù)）。

需要區(qū)分的是：事件與信號并不相同。

比如：鼠標單擊按鈕，鼠標事件（QMouseEvent），而按鈕本身發(fā)射clicked（）信號。一般而言我們只需要關注單擊信號，不用考慮鼠標事件。但是當我們要對該按鈕做額外操作，不想通過信號處理，此時事件就是一個很好的選擇。關閉事件（QCloseEvent）是一個常用的事件。

---

一，事件

Qt 中所有事件類都繼承于 QEvent。在事件對象創(chuàng)建完畢后，Qt 將這個事件對象傳遞給 QObject 的 event()函數(shù)。event()函數(shù)并不直接處理事件，而是按照事件對象的類型分派給特定的事件處理函數(shù)（eventhandler）。

信號是通過connect（）來綁定槽函數(shù)處理響應，那么事件是怎么處理的呢？

處理事件有5種常用的方法：

1. 重新實現(xiàn)部件的paintEvent（）、mousePressEvent()等事件處理函數(shù)。這是最常用的一種方法，不過只能用來處理特定部件的特定事件（即需要新建類去實現(xiàn)）

2. 重新實現(xiàn)notify（）函數(shù)。這個函數(shù)的功能強大，提供了完全的控制，可以再事件過濾器得到事件之間就獲得他們。但是，它一次只能處理一個事件。

3. 向QApplication對象上安裝事件過濾器。因為一個程序只有一個QApplication對象，實現(xiàn)的功能和notify（）函數(shù)相同，優(yōu)點是可以同時處理多個事件。

4. 重新實現(xiàn)event（）函數(shù)。QObject類的event（）函數(shù)可以在事件達到默認事件處理函數(shù)之前獲得該事件。

5. 在對象上安裝事件過濾器。使用事件過濾器可以再一個界面類中同時處理不同子部件的事件（在本類中實現(xiàn)）

實際編程中最常用的是方法（1），其次是方法（5）。方法2要繼承QApplication類，方法3需要全局的事件過濾器，減緩事件的傳遞。

鼠標事件：

常用的鼠標事件：（本篇處理事件用的是方法一：重寫鼠標事件）

• void mousePressEvent(QMouseEvent *event); //單擊

• void mouseReleaseEvent(QMouseEvent *event); //釋放

• void mouseDoubleClickEvent(QMouseEvent *event); //雙擊

• void mouseMoveEvent(QMouseEvent *event); //移動

• void wheelEvent(QWheelEvent *event); //滑輪

鼠標事件使用的時候，加頭文件： #include <QMouseEvent>

重寫事件框架：

1??鼠標按下事件

void Widget::mousePressEvent(QMouseEvent *event)
{
    // 如果是鼠標左鍵按下   
    if(event->button() == Qt::LeftButton){
        ···
    }
    // 如果是鼠標右鍵按下
    else if(event->button() == Qt::RightButton){
       ···
    }
}

2??鼠標移動事件

void Widget::mouseMoveEvent(QMouseEvent *event)
{
    // 這里必須使用buttons()
    if(event->buttons() & Qt::LeftButton){  //進行的按位與
       ···
    }
}

默認情況下，觸發(fā)事件需要點擊一下，才能觸發(fā)?？稍O置為自動觸發(fā):setMouseTracking(true);

3??鼠標釋放事件

void Widget::mouseReleaseEvent(QMouseEvent *event)
{
   ···
}

4??鼠標雙擊事件

void Widget::mouseDoubleClickEvent(QMouseEvent *event)
{
    // 如果是鼠標左鍵按下
    if(event->button() == Qt::LeftButton){
      
        ···
    }
}

5??滾輪事件

void Widget::wheelEvent(QWheelEvent *event)
{
    // 當滾輪遠離使用者時
    if(event->delta() > 0){
        ···
    }else{//當滾輪向使用者方向旋轉時
        ···
    }
}

實例演示（在label控件中，移動鼠標獲取實時位置，并顯示在界面上）

• 創(chuàng)建mylabel類，基類設置為QLabel

這里用了類似自定義控件的方法，對Mylabel類進行封裝。設置基類QLabel 是為了在ui界面中提升label控件（即將label控件和Mylabel關聯(lián)，提升時候必須二者基類相同）

• 在mylabel.h中聲明鼠標事件

#pragma once
#include <qlabel.h>

class mylabel : public QLabel
{
public:
    mylabel(QWidget* parent = 0);
    ~mylabel();
public:
    //鼠標移動事件
    void mouseMoveEvent(QMouseEvent* event);
    //鼠標按下事件
    void mousePressEvent(QMouseEvent* event);
    //鼠標釋放事件
    void mouseReleaseEvent(QMouseEvent* event);
};

• 在mylabel.cpp中重寫事件

#include "mylabel.h"
#include"QMouseEvent"


mylabel::mylabel(QWidget* parent) :QLabel(parent)
{
    
}
mylabel::~mylabel()
{

}
//鼠標移動顯示坐標
void mylabel::mouseMoveEvent(QMouseEvent* event)
{
    if (event->buttons() & Qt::LeftButton)  //進行的按位與（只有左鍵點擊移動才滿足）
    { 
        QString str = QString("Move:(X:%1,Y:%2)").arg(event->x()).arg(event->y());
         this->setText(str);
         
    }
    
}
//鼠標按下顯示“ok，mouse is press”
void mylabel::mousePressEvent(QMouseEvent* event)
{
    setText("Ok, mouse is press");

}
//鼠標釋放清除顯示
void mylabel::mouseReleaseEvent(QMouseEvent* event)
{
    setText(" ");
}

• 在主函數(shù)（QTest.cpp）中聲明mylabel的類對象（即聲明一個mylabel類的label控件）

#include "qtest.h"

QTest::QTest(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);
    //聲明mylabel類的控件
    mylabel* label1 = new mylabel(this);
    label1->setGeometry(QRect(130, 100, 271, 161));
    //設置邊框
    label1->setFrameShape(QFrame::Panel);
}

另外，當調(diào)用setMouseTracking(true);時（即設置鼠標狀態(tài)為自動觸發(fā)），需要將鼠標移動事件的if語句去掉（因為不需要點擊觸發(fā)了）

修改maylabel.cpp事件：

#include "mylabel.h"
#include"QMouseEvent"


mylabel::mylabel(QWidget* parent) :QLabel(parent)
{
    //設置鼠標狀態(tài)（自動觸發(fā)）
    setMouseTracking(true);
}
mylabel::~mylabel()
{

}
//鼠標移動顯示坐標
void mylabel::mouseMoveEvent(QMouseEvent* event)
{
   QString str = QString("Move:(X:%1,Y:%2)").arg(event->x()).arg(event->y());
   this->setText(str);
}
//鼠標按下顯示“ok，mouse is press”
void mylabel::mousePressEvent(QMouseEvent* event)
{
    setText("Ok, mouse is press");

}
//鼠標釋放清除顯示
void mylabel::mouseReleaseEvent(QMouseEvent* event)
{
    setText(" ");
}

效果展示：

---

??這里用的是代碼創(chuàng)建label控件，那么能不能用ui界面編輯然后在對label控件提升呢？

答案是可以的，但是需要注意的是：此處不能選擇全局包含

否則會出現(xiàn)：

我想其中的原因主要是因為：

本實例是新建了一個mylabel類，而不是像QT常用控件（三）——自定義控件封裝 - 唯有自己強大 - 博客園 (cnblogs.com)這篇博文中直接新添加了一個設計師界面類（即包含ui .h .cpp)。當選擇全局包含時，就包含了主類。

其實也有解決的辦法：需要在提升界面的頭文件處，將工程目錄下自定義控件的地址放于此處(本篇地址：C:/Users/WFD/Desktop/QTest/QTest/mylabel.h）

---

二，事件的分發(fā)：event函數(shù)

上面提到的xxxEvent函數(shù)，稱為事件處理器（event handler）。而event函數(shù)的作用就在于事件的分發(fā)。如果想在事件的分發(fā)之前就進行一些操作，比如監(jiān)聽（阻塞）鼠標按下事件。

如果希望在事件分發(fā)之前做一些操作，就可以重寫這個 event()函數(shù)了。比如我們希望阻塞鼠標按下事件，那么我們就在新建的Mylabel類中重寫event()函數(shù)（該類的父類是QLabel）

• 在Mylabel.h中聲明event事件

#include"qlabel.h"
class Mylabel : public QLabel
{
public:
    explicit Mylabel(QWidget* parent = 0);

    //鼠標按下事件
    void mousePressEvent(QMouseEvent* event); 
    //鼠標釋放事件
    void mouseReleaseEvent(QMouseEvent* event);
    //聲明event事件
    bool event(QEvent* e);
};

• 在Mylabel.cpp中重寫event事件。

#include "Mylabel.h"
#include"QMouseEvent"

Mylabel::Mylabel(QWidget* parent) :QLabel(parent)
{

}

//重寫鼠標按下事件
void Mylabel::mousePressEvent(QMouseEvent* event)
{
    this->setText(QString("mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
}
//重寫鼠標釋放事件
void Mylabel::mouseReleaseEvent(QMouseEvent* event)
{
    this->setText("mouse is release ");
}
//重寫event事件
bool Mylabel::event(QEvent* e)
{
    //如果鼠標按下，再事件分發(fā)中做攔截
    if (e->type()==QEvent::MouseButtonPress)
    {
        //靜態(tài)轉換（將QEvent的對象轉換為QMouseEvent對象）
        QMouseEvent* event = static_cast<QMouseEvent*>(e);
        this->setText(QString("event mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
        return true;//返回ture，說明用戶自己處理事件，不往下分發(fā)（即攔截上面的按下事件）
    }
    return QLabel::event(e);
}

點擊鼠標可以看到，觸發(fā)的是event的事件（即阻塞了mousePressEvent的事件）。特別需要注意的是：在將不需要阻塞分發(fā)的時候，需要分發(fā)給父類的event函數(shù)處理。即（return QLable::event(e)；)

由此可以見，event()是一個集中處理不同類型的事件的地方。如果你不想重寫一大堆事件處理器，就可以重寫這個 event()函數(shù)，通過 QEvent::type()判斷不同的事件。鑒于重寫 event()函數(shù)需要十分小心注意父類的同名函數(shù)的調(diào)用，一不留神就可能出現(xiàn)問題，所以一般還是建議只重寫事件處理器（當然，也必須記得是不是應該調(diào)用父類的同名處理器）。

三，事件過濾器（Even Filter）

某些應用場景下，需要攔截某個組件發(fā)生的事件，讓這個事件不再向其他組件進行傳播，這時候可以為這個組件或其父組件安裝一個事件過濾器，該過濾器在event分發(fā)之前進行攔截。

事件的過濾有兩個步驟：

1??對QObject組件安裝過濾器（調(diào)用installEvenFilter函數(shù)）

void QObject::installEventFilter ( QObject * filterObj );

參數(shù)filterobj 是指誰為組件安裝過濾器（一般是父類）

• 這個函數(shù)接受一個 QObject *類型的參數(shù)。記得剛剛我們說的，eventFilter()函數(shù)是 QObject 的一個成員函數(shù)，因此，任意 QObject 都可以作為事件過濾器（問題在于，如果你沒有重寫 eventFilter()函數(shù)，這個事件過濾器是沒有任何作用的，因為默認什么都不會過濾）。已經(jīng)存在的過濾器則可以通過QObject::removeEventFilter()函數(shù)移除。

• 我們可以向一個對象上面安裝多個事件處理器 ，只要調(diào)用多次installEventFilter()函數(shù)。如果一個對象存在多個事件過濾器，那么，最后一個安裝的會第一個執(zhí)行，也就是后進先執(zhí)行的順序。

2??事件過濾器的重寫（evenFilter函數(shù)）

virtual bool QObject::eventFilter ( QObject * watched, QEvent * event );

可以看到，函數(shù)有兩個參數(shù)，一個為具體發(fā)生事件的組件，一個為發(fā)生的事件（產(chǎn)生的QEvent對象）。當事件是我們感興趣的類型，可以就地進行處理，并令其不再轉發(fā)給其他組件。函數(shù)的返回值也是bool類型，作用跟even函數(shù)類似，返回true為不再轉發(fā)，false則讓其繼續(xù)被處理。

實例：通過事件過濾器阻塞上面代碼中的鼠標按下事件

#include "qtest.h"
#include"qmouseevent"

QTest::QTest(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);
    //第一步：給label添加過濾器
    ui.label->installEventFilter(this);


}
//第二步：重寫過濾事件
bool QTest::eventFilter(QObject* obj, QEvent* e)
{
    if (obj == ui.label)
    {
        //如果鼠標按下，再事件分發(fā)中做攔截
        if (e->type() == QEvent::MouseButtonPress)
        {
            QMouseEvent* event = static_cast<QMouseEvent*>(e);
            ui.label->setText(QString("eventfilter mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
            return true;//返回ture，說明用戶自己處理事件，不往下分發(fā)（即攔截上面的按下事件）
        }
    }
    return QWidget::eventFilter(obj, e);
}

//重寫鼠標按下事件
void QTest::mousePressEvent(QMouseEvent* event)
{
    ui.label->setText(QString("mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
}

//重寫事件分發(fā)
bool QTest::event(QEvent* e)
{
    //如果鼠標按下，再事件分發(fā)中做攔截
    if (e->type() == QEvent::MouseButtonPress)
    {
        QMouseEvent* event = static_cast<QMouseEvent*>(e);
        ui.label->setText(QString("event mouse is press x:%1,y:%2").arg(event->x()).arg(event->y()));
        return true;//返回ture，說明用戶自己處理事件，不往下分發(fā)（即攔截上面的按下事件）
    }
    return QWidget::event(e);
}

運行結果：

可以看到在過濾器事件中就監(jiān)聽了鼠標按壓（即阻塞了后面的事件分發(fā)和鼠標按壓）文章來源地址http://www.zghlxwxcb.cn/news/detail-488670.html