博客

目录

事件分发函数

无边框窗口拖动

自定义事件

发送事件的函数

自定义事件

系统定义的事件号

自定义事件号

自定义事件类

发送和处理事件

sendEvent与postEvent的区别

栈区对象

堆区对象

事件传播机制

事件传播的过程

事件传播到父组件

鼠标单击事件与按钮单击信号的关联

事件过滤

无边框窗口拖动（事件过滤器实现）

事件跟信号的区别

事件分发函数

传递事件的通常方式是调用虚函数。例如，QMouseEvent通过调用QWidget::mousePressEvent()来传递。这个虚函数负责进行适当的响应，通常是处理鼠标点击，并发出对应的信号。如果在虚函数的实现中不执行所有必要的工作，则可能需要调用基类的实现。

如果希望替换基类的事件处理函数，则必须自己实现所有内容。但是，如果您只想扩展基类的功能，那么您可以实现您想要的功能，并调用基类来获得您不想处理的任何情况的默认行为。

有时，没有这样一个特定于事件的函数，或者特定于事件的函数是不够的。最常见的例子是按Tab键。通常情况下，QWidget会拦截这些来移动键盘焦点，但也有一些小部件本身需要Tab键。

这些对象可以重新实现QObject::event()(通用事件处理程序)，并在通常处理之前或之后执行它们的事件处理，或者它们可以完全替换函数。一个非常不寻常的小部件既解释Tab又具有特定于应用程序的自定义事件，它可能包含以下event()函数:

bool Widget::event(QEvent* ev)override
{
    //如果是按键按下事件
    if (ev->type() == QEvent::Type::KeyPress)
    {
        QKeyEvent* ke = static_cast<QKeyEvent*>(ev);
        if (ke->key() == Qt::Key::Key_Tab)
        {
            //对tab键按下进行处理
            qInfo() << "处理 tab 按键...";
            return true;    //返回true表示此事件已经处理了，不会继续传播
        }
    }
    // 调用父类实现处理其它的事件
    return QWidget::event(ev);
}

注意：

对于所有未处理的情况，仍然调用QWidget::event()，并且返回值指示是否处理了事件;true值防止事件被发送到其他对象。返回true表示此事件已经处理了，不需要再处理了。

无边框窗口拖动

使用事件分发函数实现无边框窗口的拖动

bool event(QEvent* ev)override
{
    if (ev->type() == QEvent::MouseButtonPress)
    {
        auto me = static_cast<QMouseEvent*>(ev);
        pressPos = me->pos();
        return true;
    }
    else if (ev->type() == QEvent::MouseMove)
    {
        auto me = static_cast<QMouseEvent*>(ev);
        //如果鼠标左键是按下的
        if(me->buttons() & Qt::MouseButton::LeftButton)
            this->move(me->globalPosition().toPoint() - pressPos);
        return true;
    }
    return QWidget::event(ev);
}

自定义事件

发送事件的函数

许多应用程序都希望创建和发送它们自己的事件。通过构造合适的事件对象并使用QCoreApplication::sendEvent()和QCoreApplication::postEvent()发送事件，您可以以与Qt自己的事件循环完全相同的方式发送事件。

sendEvent()

立即处理事件。当它返回时，事件过滤器和/或对象本身已经处理了该事件。对于许多事件类，都有一个名为isAccepted()的函数，它告诉您事件是被最后一个调用的处理程序接受还是拒绝的。

postEvent()

将事件发送到队列中，以便稍后进行分派。下次Qt的主事件循环运行时，它会分发所有发布的事件，并进行一些优化。例如，如果有几个调整大小事件，它们将被压缩为一个。同样适用于绘制事件:QWidget::update()调用postEvent()，它通过避免多次重绘来消除闪烁并提高速度。

自定义事件

要创建自定义类型的事件，需要定义一个事件号，该事件号必须大于等于QEvent::User，并且可能需要继承QEvent的子类，以便传递关于自定义事件的特定信息。有关更多详细信息，请参阅QEvent文档。

系统定义的事件号

QEvent::Type 这个枚举类型定义了Qt中有效的事件类型。事件类型和每个类型的专门类如下：

用户事件的值应该介于 QEvent::User 和 QEvent::MaxUser之间。

为方便起见，可以使用



[static] int QEvent::registerEventType(int *hint* = -1)



函数来注册和存储一个自定义事件类型，这样做会

避免

意外地

重用

一个自定义事件类型。

自定义事件号

enum EventType 
{
    NumberEvent = QEvent::Type::User
};

自定义事件类

// 自定义事件类
class NumberChangeEvent : public QEvent
{
public:
    NumberChangeEvent(int number)
        : QEvent(QEvent::Type(NumberEvent))
        , m_number(number)
    {

    }
    ~NumberChangeEvent()
    {
        qInfo() << __FUNCTION__;
    }
    qint32 getNumber(){ return m_number; }
private:
    int m_number;
};

发送和处理事件

#include <QApplication>
#include <QWidget>
#include <QEvent>
#include <QPushButton>

// 自定义事件类型
enum EventType
{
    NumberEvent = QEvent::Type::User
};

// 自定义事件类
class NumberChangeEvent : public QEvent
{
public:
    NumberChangeEvent(int number)
        : QEvent(QEvent::Type(NumberEvent))
        , m_number(number)
    {

    }
    ~NumberChangeEvent()
    {
        qInfo() << __FUNCTION__;
    }
    qint32 getNumber(){ return m_number; }
private:
    int m_number;
};

// 自定义事件处理
class Widget : public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget* parent = nullptr)
        :QWidget(parent)
    {
        resize(640,480);

        m_btn = new QPushButton("发送自定义事件", this);
        // 点击按钮发送事件
        connect(m_btn, &QPushButton::clicked, this, [=](){
            static int i = 0;
            NumberChangeEvent ne(i++);
            //qApp->sendEvent(this, &ne);
            QApplication::sendEvent(this, &ne);
        });
    }
    ~Widget()
    {

    }
protected:
    bool event(QEvent* ev) override
    {
        if(ev->type() == QEvent::Type(NumberEvent))
        {
            auto nev = static_cast<NumberChangeEvent*>(ev);
            qInfo() << "Number: " << nev->getNumber();
        }

        return QWidget::event(ev);
    }
private:
    QPushButton* m_btn;
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    Widget w;
    w.show();

    return a.exec();
}
#include "main.moc"

除了使用事件分发函数event处理自定义事件外，也可以使用

customEvent

处理自定义事件，它是专门用来接收自定义事件。

void customEvent(QEvent* ev) override
{
    if(ev->type() == EventType::NumberEvent)
    {
        auto nev = static_cast<NumberChangeEvent*>(ev);
        qInfo() << "Number: " << nev->getNumber();
    }
}

sendEvent与postEvent的区别

使用栈区对象与堆区对象分别对两种发送方式进行测试

栈区对象

connect(m_btn, &QPushButton::clicked, this, [=](){
    NumberChangeEvent ne1(1);
    QApplication::sendEvent(this, &ne1);

    NumberChangeEvent ne2(1);
    QApplication::postEvent(this, &ne2);
});

当使用postEvent发送栈区事件对象时会直接引发中断，因为postEvent是将事件放入事件队列中稍后处理，栈区事件对象出作用域后内存就会被释放，我认为这是引发中断的原因。而使用sendEvent发送栈区事件对象不会中断，内存也会自己释放（出作用域后释放）。

堆区对象

当使用sendEvent发送堆区对象后，内存不会被自动释放，需要手动释放。而使用postEvent发送堆区事件对象内存会自动释放，不必手动释放。

因此，当使用栈区对象时只能使用sendEvent发送事件，使用堆区对象时，使用sendEvent发送事件之后需要手动释放事件对象内存，使用postEvent发送事件会自动释放内存。另外，使用postEvent发送事件时可以设置事件的优先级，让发送的事件被优先处理。

事件传播机制

事件传播的过程

Qt的事件产生之后，不是直接传递给了对象的，需要经过一系列的过程。

1. 事件首先由Qt的ServerApplication去接收来自于外部或内部的一些行为，鼠标点击，键盘输入，时钟事件等，分析并决定送往对应的对象去处理(内部管理机制)，最后会调用[virtual] bool QCoreApplication::notify ( QObject * receiver, QEvent * event ) 去处理，当然这个是虚函数，你可以在子类去重新实现它 。

2. 在notify(…)中，在发给对应的接收者前，会先把消息送给QApplication。所以如果想在你界面的Widget前先处理那些事 件，那么你可以给QApplication对象installEventFilter,然后在对应的eventFilter()里先把这些事件都给过一 遍，然后你可以过滤一些不必要事件。

3. 如果QApplication没有处理那些事件，然后就是交给事件接收对象了。在这个对象接收前，也可以为这对象加一个事件过滤器，同样是 installEventFilter。

4. 如果eventFilter没有过滤某些事件，那么就会将事件交给接收者的event()函数（你可以根据不同类型的事件尽情处理），如果event事件在接受者处理后，也不会上传给父类的event，否则会上传进入父类的event。

5. 默认event()函数根据事件类型会调用不同的事件处理函数,类似mousePressEvent(),keyPressEvent()去分别处理他们。

事件传播到父组件

当控件忽略事件时，事件会继续往上传播，这里的传播是指

传播给父组件

。

• QEvent有
  
accept()

  函数 和
  
ignore()

  函数：

  • 
    accept()：
    
    本组件处理该事件，这个事件就不会被继续传播给其父组件；

  • 
    ignore()：
    
    本组件不想要处理这个事件，这个事件会被继续传播给其父组件；

  • 值得注意的是所有的事件默认都是接受的（即不会传递到父组件）

• 忽略和接受案例

当默认接受事件时，在本组件处理之后，事件不会传递到父组件mousePressEvent处理。

#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QMouseEvent>

class Button : public QPushButton
{
public:
    Button(const QString& text,QWidget* parent = nullptr)
        :QPushButton(text,parent)
    {

    }
    void mousePressEvent(QMouseEvent* ev)override
    {
        qInfo() << __FUNCTION__;
        //默认是接受事件的，父组件不会收到鼠标点击事件
        ev->accept();
        //如果忽略事件，父组件就会收到鼠标点击事件
        //ev->ignore();
    }
};

class Widget : public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget* parent = nullptr)
        :QWidget(parent)
    {
        resize(640,480);

        Button* btn = new Button("text", this);
    }
    ~Widget()
    {

    }
protected:
    void mousePressEvent(QMouseEvent* ev)override
    {
        qInfo() << __FUNCTION__;
    }
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    Widget w;
    w.show();

    return a.exec();
}
#include "main.moc"

当忽略事件时，在本组件处理之后，事件会被传递到父组件mousePressEvent处理。

class Button : public QPushButton
{
public:
    Button(const QString& text,QWidget* parent = nullptr)
        :QPushButton(text,parent)
    {

    }
    void mousePressEvent(QMouseEvent* ev)override
    {
        qInfo() << __FUNCTION__;
        //默认是接受事件的，父组件不会收到鼠标点击事件
        //ev->accept();
        //如果忽略事件，父组件就会收到鼠标点击事件
        ev->ignore();
    }
};

• event事件分发函数返回值的作用

#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QMouseEvent>

class Button : public QPushButton
{
public:
    Button(const QString& text,QWidget* parent = nullptr)
        :QPushButton(text,parent)
    {

    }
    bool event(QEvent* ev)override
    {
        if (ev->type() == QEvent::Type::MouseButtonPress)
        {
            qInfo() << __FUNCTION__;
            return false;	//返回false，表示我没有处理这个事件，可以传递给父组件
            //return true;	//返回true，表示我处理了这个事件，不再继续传递了
        }
        return QPushButton::event(ev);
    }
};

class Widget : public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget* parent = nullptr)
        :QWidget(parent)
    {
        resize(640,480);

        Button* btn = new Button("text", this);
        Q_UNUSED(btn)
    }
    ~Widget()
    {

    }
protected:
    bool event(QEvent* ev)override
    {
        if (ev->type() == QEvent::Type::MouseButtonPress)
        {
            qInfo() << __FUNCTION__;
        }
        return QWidget::event(ev);
    }
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    Widget w;
    w.show();

    return a.exec();
}
#include "main.moc"

事件分发函数event返回

false

，表示本组件

没有处理

这个事件，事件会被

传递到父组件

处理，返回

true

则表示本组件

处理了

这个事件，

不需要再让父组件处理

了。

鼠标单击事件与按钮单击信号的关联

class Button : public QPushButton
{
public:
    Button(const QString& text,QWidget* parent = nullptr)
        :QPushButton(text,parent)
    {

    }
    void mousePressEvent(QMouseEvent* ev) override
    {
        //return QPushButton::mousePressEvent(ev);
    }
};

Button* btn = new Button("text", this);
connect(btn, &Button::clicked, this, [](){
    qInfo() << "鼠标单击";
});

要想触发鼠标点击的信号与槽就必须处理鼠标按下事件

void mousePressEvent(QMouseEvent* ev) override
{
    return QPushButton::mousePressEvent(ev);
}

事件过滤

有的时候，对象需要查看(可能还需要拦截)传递给另一个对象的事件。例如，对话框通常想要过滤一些小部件的按键;例如，修改返回键处理。

QObject::installEventFilter()函数通过设置一个事件过滤器来实现这一点，使指定的过滤器对象在其QObject::eventFilter()函数中接收目标对象的事件。事件过滤器在目标对象处理事件之前处理事件，允许它根据需要检查和丢弃事件。可以使用QObject::removeEventFilter()函数删除现有的事件过滤器。

当调用过滤器对象的eventFilter()实现时，它可以接受或拒绝事件，并允许或拒绝对事件的进一步处理。如果所有事件过滤器都允许对事件进行进一步处理(每个返回false)，则将事件发送到目标对象本身。如果其中一个停止处理(通过返回true)，目标和任何后面的事件过滤器都不会看到事件。

无边框窗口拖动（事件过滤器实现）

class Widget : public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget* parent = nullptr)
        :QWidget(parent)
    {
        resize(640, 480);
        setWindowFlag(Qt::WindowType::FramelessWindowHint);
        setMouseTracking(true);
        // 安装事件过滤器
        this->installEventFilter(this);
    }
    bool eventFilter(QObject* object, QEvent* ev)override
    {
        auto w = qobject_cast<QWidget*>(object);
        if (!w)
            return false;

        if (ev->type() == QEvent::MouseButtonPress)
        {
            auto me = static_cast<QMouseEvent*>(ev);
            pressPos = me->pos();
            return true;
        }
        else if (ev->type() == QEvent::MouseMove)
        {
            auto me = static_cast<QMouseEvent*>(ev);
            if (me->buttons() & Qt::MouseButton::LeftButton)
                w->move(me->globalPosition().toPoint() - pressPos);
            // 已经处理了，不需要再处理MouseMoveEvent事件了
             return true;
        }
        return QObject::eventFilter(object, ev);
    }
private:
    QPoint pressPos;
};

在自己类里面重写eventFilter来过滤事件，但是如果我有很多个无边框窗口，都要实现移动，这个方法就不太方便了。可以先写一个拖拽控件的过滤器对象，然后哪儿需要使用，就直接加载事件过滤器对象即可。

// 无边框窗口拖拽的事件过滤器对象
class DragWidgetFilter :public QObject
{
public:
    DragWidgetFilter(QObject* parent = nullptr)
        :QObject(parent)
    {

    }
    bool eventFilter(QObject* object,QEvent*ev)override
    {
        auto w = qobject_cast<QWidget*>(object);
        if (!w)
            return false;

        if (ev->type() == QEvent::MouseButtonPress)
        {
            auto me = static_cast<QMouseEvent*>(ev);
            pressPos = me->pos();
        }
        else if (ev->type() == QEvent::MouseMove)
        {
            auto me = static_cast<QMouseEvent*>(ev);
            if (me->buttons() & Qt::MouseButton::LeftButton)
                w->move(me->globalPosition().toPoint() - pressPos);
        }
        return QObject::eventFilter(object,ev);
    }
private:
    QPoint pressPos;
};

class Widget : public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget* parent = nullptr)
        :QWidget(parent)
    {
        resize(640, 480);
        setWindowFlag(Qt::WindowType::FramelessWindowHint);
        setMouseTracking(true);
        // 使用事件过滤器对象加载事件过滤器
        this->installEventFilter(new DragWidgetFilter(this));
    }
}

事件跟信号的区别