【VS Code 與 Qt6】運用事件過濾器批量操作子級組件

如果某個派生自 QObject 的類重寫 eventFilter 方法,那它就成了事件過濾器(Event Filter)。該方法的聲明如下:

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

watched 參數是監聽事件的對象,即事件的接收者;event 參數當然就是待處理的事件了。事件過濾器(也可以翻譯爲“篩選器”)可在接收者之前攔截事件,處理完畢後還可以決定是否把事件轉發給接收者。如果不想轉發給事件接收者,就返回 true;若還想讓事件繼續傳播就返回 false。

這玩意兒最有益的用途就是:你的頂層窗口上有 K 個子級組件(正常情形是 QWidget 的子類),如果組件沒有定義你想用的信號,只能通過處理事件的途徑解決,可你又不想只爲了處理一個事件就派生一個類(比如,QLabel組件在鼠標懸浮時做點事情),就可以用上事件過濾器了。頂層窗口類重寫 eventFilter 方法,攔截髮往子組件的事件(如mouseMove)直接處理,這樣能節省 N 百行代碼。

重寫了 eventFilter 方法的類就成了事件的過濾者,而調用 installEventFilter 方法安裝過濾器的類纔是事件的原始接收者。就拿上文咱們舉的 QLabel 組件的例,假設頂層窗口的類名是 DuckWindow,那麼,DuckWindow 重寫 eventFilter 方法,它就是事件的攔截者;而 QLabel 組件就是事件的原始接收者,所以,調用 installEventFilter 方法的是它。即 QLabel::installEventFilter( DuckWindow )。

不知道老周這樣說大夥伴們能否理解。就是負責過濾事件的對象重寫 eventFilter 方法;被別人過濾的對象才調用 installEventFilter 方法。

我們用示例說事。下面咱們要做的練習是這樣的:

我定義了一個類叫 MyWindow,繼承 QWidget 類,作爲頂層窗口。然後在窗口裏,我用一個 QHBoxLayout 佈局,讓窗口內的子級組件水平排列。但每個子組件的顏色不同。常規做法是寫個自定義組件類,從構造函數或通過成員函數傳一個 QColor 對象過去,然後重寫 paintEvent 方法繪圖。這種做法肯定沒問題的。但是!我要是不想寫自定義類呢,那就得考慮事件過濾器了,把 paintEvent 事件過濾,直接用某顏色給子組件畫個背景就行了。

頭文件聲明 MyWindow 類。

#ifndef MYWIN
#define MYWIN

#include <QWidget>
#include <QHBoxLayout>
#include <QPainter>
#include <QEvent>
#include <QColor>
#include <QRect>

class MyWindow : public QWidget
{
    Q_OBJECT
public:
    MyWindow(QWidget* parent=nullptr);
    bool eventFilter(QObject *obj, QEvent *event) override;
private:
    // 私有成員,畫痘痘用的
    void paintSomething(QPainter *p, const QColor &color, const QRect &paintRect);
    // 佈局
    QHBoxLayout *layout;
    // 三個子級組件
    QWidget *w1, *w2, *w3;
}; 

#endif

這裏提一下這個 eventFilter 方法,這廝聲明爲 public 和 protected 都是可行的。老周這裏就聲明爲 public,與基類的聲明一致。

paintSomething 是私有方法,自定義用來畫東西的。有夥伴們會問:QPainter 的 paintDevice 不是可以獲取到繪圖設置(這裏指窗口或組件)的大小的矩形區域嗎,爲啥要從參數傳個 QRect?因爲這個 rect 來自 QPaintEvent 對象的事件參數,它指的可不一定窗口/組件的整個矩形區域。如果是局部重繪,這個矩形可能就是其中一小部分區域。所以,咱們用事件傳遞過來的矩形區域繪圖。

窗口布局用的是 QHBoxLayout,非常簡單的佈局方式,子級組件在窗口上水平排列。

下面代碼實現構造函數,初始化各個對象。

MyWindow::MyWindow(QWidget *parent)
    : QWidget(parent)
{
    // 初始化
    layout = new QHBoxLayout;
    this->setLayout(layout);
    w1 = new QWidget(this);
    w2 = new QWidget(this);
    w3 = new QWidget(this);
    layout->addWidget(w1);
    layout->addWidget(w2);
    layout->addWidget(w3);
    // 安裝事件過濾器
    w1->installEventFilter(this);
    w2->installEventFilter(this);
    w3->installEventFilter(this);
}

只有在被攔截的對象上調用 installEventFilter 方法綁定過濾器後,事件過濾器纔會生效。此處,由於 MyWindow 類重寫了 eventFilter 方法,所以過濾器就是 this。

下面是 eventFilter 方法的實現代碼,只過濾 paint 事件即可,其他傳給基類自己去玩。

bool MyWindow::eventFilter(QObject *obj, QEvent *event)
{
    // 如果是paint事件
    // 這裏“與”判斷事件接收者是不是在那三個子組件中
    // 防止有其他意外對象出現
    // 不過這裏不會發生,因爲只有install了過濾器的對象纔會被攔截事件
    if(event->type() == QEvent::Paint
        && (obj==w1 || obj==w2 || obj==w3))
    {
        QPaintEvent* pe = static_cast<QPaintEvent*>(event);
        QWidget* uiobj = static_cast<QWidget*>(obj);
        QPainter painter;
        // 注意這裏,繪圖設備不是this了,而是接收繪圖事件的對象
        // 由於它要求的類型是QPaintDevcie*,所以要進行類型轉換
        // 轉換後的uiobj變量的類型是QWidget*,傳參沒問題
        painter.begin(uiobj);
        if(w1 == uiobj)
        {
            // 紅色
            paintSomething(&painter, QColor("red"), pe->rect());
        }
        if(w2 == uiobj)
        {
            // 橙色
            paintSomething(&painter, QColor("orange"), pe->rect());
        }
        if(w3 == uiobj)
        {
            // 紫色
            paintSomething(&painter, QColor("purple"), pe->rect());
        }
        painter.end();
        return true;
    }
    return QWidget::eventFilter(obj, event);
}

攔截並處理了 paint 事件後,記得返回 true,這樣事件就不會傳給目標對象了(咱們幫它處理了,不必再重複處理,畢竟 QWidget 類默認的 paint 事件是啥也不做)。

下面代碼是 paintSomething 方法。只是畫了顆巨型青春痘……哦不,是一個橢圓。

void MyWindow::paintSomething(QPainter *p, const QColor &color, const QRect &paintRect)
{
    // 設置畫刷
    p->setBrush(QBrush(color));
    // 無輪廓
    p->setPen(Qt::NoPen);
    // 畫橢圓
    p->drawEllipse(paintRect);
}

setPen中設定 NoPen 是爲了在繪製圓時去掉輪廓,默認會畫上輪廓線的。

最後,該到 main 函數了。

int main(int argc, char **argv)
{
    QApplication app(argc,argv);
    MyWindow wind;
    // 窗口標題
    wind.setWindowTitle("乾點雜活");
    // 調整窗口大小
    wind.resize(321, 266);
    wind.show();
    return QApplication::exec();
}

運行一下,看,橫躺着三顆痘痘,多好看。

 

再來一例,這次咱們攔截的是窗口的 close 事件,當窗口要關閉的時候,咱們輸出一條調試信息。

#ifndef 奶牛
#define 奶牛

#include <QObject>
#include <QEvent>

class MyFilter : public QObject
{
protected:
    bool eventFilter(QObject *obj, QEvent *e) override;
};

#endif

這次我們不從任何可視化類型派生,而是直接派生自 QObject 類。這裏只是重寫 eventFilter 方法,沒有用到信號和 cao,所以,可以不加 Q_OBJECT 宏。也就是說咱們這個過濾器是獨立用的,不打算加入到 Qt 的對象樹中。

下面是實現代碼:

bool MyFilter::eventFilter(QObject *obj, QEvent *e)
{
    if(e->type() == QEvent::Close)
    {
        // 此處要類型轉換
        QWidget* window = qobject_cast<QWidget*>(obj);
        // 看看這貨是不是窗口(有可能是控件)
        if(window->windowFlags() & Qt::Window)
        {
            // 獲取這個窗口的標題
            QString title = window->windowTitle();
            // 輸出調試信息
            qDebug() << "正在關閉的窗口:" << title;
        }
    }
    // 事件繼續傳遞
    return false;
}

最好返回 false,把事件繼續傳遞給窗口,畢竟窗口可能在關閉時要做一些重要的事,比如保存打開的文件。QWidget 的 WindowFlags 如果包含 Window 值,表明它是一個窗口。

下面直接寫main函數。

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    MyFilter *filter = new MyFilter;
    // 弄三個窗口試試
    QWidget *win1 = new QWidget;
    win1->setWindowTitle("狗頭");
    win1->installEventFilter(filter);
    win1->show();

    QWidget *win2 = new QWidget;
    win2->setWindowTitle("雞頭");
    win2->installEventFilter(filter);
    win2->show();

    QWidget *win3 = new QWidget;
    win3->setWindowTitle("鼠頭");
    win3->installEventFilter(filter);
    win3->show();

    return QApplication::exec();
    // 可選
    delete filter;
    filter = nullptr;
}

filter 是指針類型,它沒有添加到 Qt 對象樹中,不會自動清理,在exec返回後用 delete 解決它。在清理時有個好習慣,就是 del 之後把指針變量重設爲 null,這樣下次再引用變量時不容易產生錯誤,只要 if(! filter) 就能測出它是空的。

反正程序都退出了,所以此處你也可以讓它泄漏一下也無妨。程序掛了後進程空間會被系統收回。

當然,用Qt專供的“作用域”指針也不錯,超出作用域自動XX掉。

int main(int argc, char **argv)
{
    QApplication app(argc, argv);

    QScopedPointer<MyFilter> filter(new MyFilter);
    // 弄三個窗口試試
    QWidget *win1 = new QWidget;
    win1->setWindowTitle("狗頭");
    win1->installEventFilter(filter.data());
    win1->show();

    QWidget *win2 = new QWidget;
    win2->setWindowTitle("雞頭");
    win2->installEventFilter(filter.data());
    win2->show();

    QWidget *win3 = new QWidget;
    win3->setWindowTitle("鼠頭");
    win3->installEventFilter(filter.data());
    win3->show();

    return QApplication::exec();
}

QScopedPointer 通過構造函數引用要封裝的對象,要訪問被封裝的指針對象,可以使用 data 成員。

運行之後,會出現三個窗口。逐個關閉,會輸出以下調試信息:

 

---------------------------------------------------------------------------------------

最後老周扯點別的。

咱們知道,Qt官方推出 Python for Qt,名曰 PySide。五月份的時候,老周遇到一個問題:PySide6 無法加載 QML 文件,報的錯誤是加載 dll 失敗,找不到指定的模塊。

網上的方法都是不行的,首先,Qt 在版本號相同(均爲 6.5.1)的情況下,C++是可以正常加載 QML 文件的。不管是生成資源文件還是直接訪問文件均可。但 Python 是報錯的。這至少說明我的機器上不缺某些 .dll,不然C++代碼應該也報錯。

接着,老周想是不是Qt官方編譯的有問題,於是,我把自己編譯的Qt動態庫替換 PySide6 裏面的動態鏈接庫。報錯依舊,那就排除編譯的差異性。

那麼,老周就想到,就是 Python 的問題了,3.7 到 3.10 幾個版本測試也報錯;用不同路徑建的虛擬環境也報錯;更換 Qt 版本(6.0 到 6.5)同樣報錯。

這時可以直接肯定就是 Python 的問題了。不是版本號的問題,是 Windows 商店安裝的 Python 就會報錯,非 Windows 商店安裝的就正常。

不過,還得再加一句話:想把 Qt 用得 666 還是用 C++ 吧,用 Python 僅適合初學和娛樂。由於 Rust 可以調用 C/C++ 代碼,所以你是可以嘗試用 Rust 的。Rust 也不是什麼鬼自動內存管理,要 GC 用 .NET 就完事了。Rust 的重點是內存安全。看似挺誘人,官方也把牛吹得入木四分。可用了之後(和用 Go 一樣的感覺),是真的沒 C++ 好用。C++ 能揹負上這麼多的歷史包袱也不是靠吹的。當然 C++ 內存泄漏也沒你想的那麼恐怖。養成好習慣,作用域短,存放數據不多的對象就直接棧分配就行了;要在不同代碼上下文傳遞對象,或分配的數據較大的,用指針。指針類型的變量,在不要的時候堅決幹掉,然後記得設置變量爲 nullptr。養成這些好習慣基本沒多大問題。

一般代碼你寫慣了是不會忘記 delete 的,容易遺漏的是龐大複雜的代碼之間會共享某些對象,在很多地方會引用到某對象。於是,碼着碼着就頭暈了,就不記得銷燬了。

會被多處引用的對象,可以寫上註釋提醒自己或別人要清理它,或者加個書籤。寫完代碼後去看看書籤列表,就會想起有哪些對象還沒銷燬。代碼寫複雜了會容易混,經常會訪問已清理的對象。於是,不妨在訪問指針變量前 if 語句一下,if (ptr),在 bool 表達式中,若指針類型的變量是空會得到 false,非空爲 true。這樣就可以避免許多低級錯誤。

哪怕是不常用指針的語言也不見得不出事。C# 裏面你要是訪問 null 的變量(VB 是 Nothing)也會報那個很經典的錯誤:“未將對象引用設置到對象的實例”,就是 NullReferenceException。在.NET 代碼中你只要看到這貨就得明白肯定有某個爲 null 的對象被訪問了。

C++ 裏面,這樣寫就能實例化 MyClass 類,只是分配在棧上。

MyClass x;

但在 C# 中,初始值是 null,即未初始化的,初始化你還得 new。哦,順便想起個事,C# 中數據的隱式基類是 Array,所以它是引用類型,初始值也是 null 的,就算你數據組裏面的元素是值類型,但數組自身是引用類型。委託也是引用類型。有的剛入門的同學會以爲委託是值類型。

C++函數按“引用”傳值的話,一般會用到指針、引用參數,如 int *p、const int &a、const char *w(不能改)等,C# 中如果是引用類型,直接聲明就行了,如 MyClass x,值類型可以用 ref 關鍵字,ref int v。

C# 中 int?、double? 等可以讓其成爲引用類型,你可以類比 C 中的 int* 等。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章