QT 事件系统

Posted on | In

事件系统

Qt事件系统是非常重要事件传递机制，所有消息传递流程都离不开这个机制，这里主要从重写类的事件响应函数，事件过滤器以及重写event函数三种方式做介绍。

重写事件函数

这种方式最为直接，我们先创建项目,选择QApplication应用，类名选择Widget，基类选择QWidget
接下来在项目中添加一个C++类命名为MyEdit项目生成后，我们为MyEdit类添加声明和实现

1
2
3
4
5
6
7
8
9
10
11
12
class MyEdit : public QLineEdit
{
    Q_OBJECT
public:
    explicit MyEdit(QWidget *parent = nullptr);

protected:
   void keyPressEvent(QKeyEvent *);
signals:

public slots:
};

MyEdit类的声明中添加了keyPressEvent函数的声明，该函数主要用来重写按键点击事件。
我们接下来实现按键点击逻辑重写

1
2
3
void MyEdit::keyPressEvent(QKeyEvent * event){
    qDebug()<<"MyEdit key press event";
}

然后我们在Widget的构造函数中初始化这个edit，并添加到Widget上

1
2
3
4
5
6
7
8
Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    line_edit_ = new MyEdit(this);
    line_edit_->move(100,100);
}

运行程序后点击lineEdit, 然后按下键盘，发现输出了”MyEdit key press event”。
但是lineEdit的基本输入功能失效了，此时我们在keyPressEvent中添加 QLineEdit::keyPressEvent

1
2
3
4
void MyEdit::keyPressEvent(QKeyEvent * event){
    qDebug()<<"MyEdit key press event";
    QLineEdit::keyPressEvent(event);
}

作用就是调用完我们的输出后，调用QLineEdit原有的按键处理逻辑，保证QLineEdit可以正常使用。

让父窗口和子窗口都响应事件

为了让父窗口也响应按键事件，在父窗口Widget里同样实现keyPressEvent

1
2
3
void Widget::keyPressEvent(QKeyEvent * event){
    qDebug()<<"Widget key press event" << endl;
}

运行程序，我们在lineEdit中输入内容，发现此时只触发MyEdit的keyPressEvent。
如果想要触发Wdiget的keyPressEvent，需要在MyEdit的keyPressEvent添加event->ignore()

1
2
3
4
5
void MyEdit::keyPressEvent(QKeyEvent * event){
    qDebug()<<"MyEdit key press event";
    QLineEdit::keyPressEvent(event);
    event->ignore();
}

event->ignore的作用是当MyEdit处理完keyPressEvent事件后，将按键消息继续抛给其父节点，也就是Widget，这样Widget就能处理按键消息了。

万能的event

我们也可以重新实现MyEdit的event函数，这个函数的作用是所有的消息优先经过event处理，然后才根据不同的事件调用具体的事件处理函数如keyPressEvent，
所以event的调用顺序优先于keyPressEvent。

1
2
3
4
5
6
7
8
bool MyEdit::event(QEvent *pevent)
{
    if(pevent->type() == QEvent::KeyPress){
        qDebug() << tr("my edit event") << endl;
    }

    return  QLineEdit::event(pevent);
}

在event里判断事件类型为KeyPress，也就是按键事件，就打印”my edit event”，然后调用QLineEdit::event，以保证其QLineEdit的原有功能。
此时在LineEdit中输入内容，就会先输出”my edit event”再输出”MyEdit key press event”。

eventFilter事件过滤器

要实现对某个控件事件的捕获，可以通过对其父窗口重写eventFilter函数，这个函数是过滤器，在这个过滤器里可以根据对象和事件类型进行。
我们在Widget类实现

1
2
3
4
5
6
7
8
9
10
11
bool Widget::eventFilter(QObject *object, QEvent *event)
{
    if(object == line_edit_){
        if(event->type() == QEvent::KeyPress){
            qDebug() << "widget eventfilter catch line_edit" << endl;
            return false;
        }
    }

    return QWidget::eventFilter(object, event);
}

在eventFilter里判断对象为line_edit_，并且事件类型为KeyPress，则打印日志，并且返回false，返回false意思是将该消息继续传递，这个按键消息会传递给MyEdit的event函数，然后是MyEdit的keyPressEvent函数。
仅仅实现eventFilter是不够的，我们需要在Widget的构造函数中加载这个过滤器。

1
line_edit_->installEventFilter(this);

这样再次运行程序，在lineEdit中按下键盘，会看到程序输出如下

1
2
3
4
widget eventfilter catch line_edit 
my edit event 
MyEdit key press event
Widget key press event

可见消息捕获的顺序是 Widget::eventfilter -> MyEdit::event-> MyEdit::keyPressEvent -> MyWidget::keyPressEvent

为多个控件添加eventFilter

我们可以在父窗口为其多个子节点控件添加eventFilter。
我们在Widget中添加两个控件QTextEdit和QSpinBox, 然后再重新实现Widget的eventFilter

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
bool Widget::eventFilter(QObject *watched, QEvent *event){

    if(watched == ui->textEdit){
        if(event->type() == QEvent::Wheel){
           QWheelEvent* wheelEvent  = static_cast<QWheelEvent*>(event);
            if(wheelEvent->delta() > 0){
                qDebug() << "catch wheel event delta > 0" << endl;
                ui->textEdit->zoomIn();
            }else {
                qDebug() << "catch wheel event delta < 0" << endl;
                ui->textEdit->zoomOut();
            }
            return true;
        }

        return false;
    }

    if(watched == ui->spinBox){
        if(event->type() == QEvent::KeyPress){
            QKeyEvent * keyEvent = static_cast<QKeyEvent*>(event);
            if(keyEvent->key() == Qt::Key_Space){
                ui->spinBox->setValue(0);
                return true;
            }
            return false;
        }
        return false;
    }

    return QWidget::eventFilter(watched, event);
}

eventFilter 中根据不同的对象实现了不同的事件捕获，对于textEdit捕获了滚轮事件
对于spinbox，捕获了空格按键。

然后在Widget的构造函数中为两个控件安装过滤器

1
2
ui->textEdit->installEventFilter(this);
ui->spinBox->installEventFilter(this);

运行程序就可以在滚轮滚动时缩放textEdit，按下空格键就可以使spinbox清零。

总结

源码链接：
https://gitee.com/secondtonone1/qt-learning-notes