qt中sendEvent()、postEvent()用法

luckyone906

已于 2022-12-09 19:50:33 修改

阅读量2.3k

点赞数 2

分类专栏： Qt事件机制 QT 文章标签： qt 开发语言

于 2022-12-09 19:22:06 首次发布

本文链接：https://blog.csdn.net/u011555996/article/details/128257973

版权

QT 同时被 2 个专栏收录

175 篇文章 53 订阅

订阅专栏

Qt事件机制

55 篇文章 27 订阅

订阅专栏

QT-事件发送函数sendEvent()、postEvent()

-阻塞型事件发送

需要重写接收对象的event()事件处理函数
当事件发送后,将会立即进入event()事件处理函数进行事件处理
通过sendEvent()静态函数实现阻塞发送:

bool QApplication::sendEvent ( QObject * receiver, QEvent * event ) ;
// receiver:接收对象, event :要发送的event类型(比如:鼠标双击)
//当有事件发送,将会调用receiver对象里的event()成员函数进行事件处理

sendEvent()函数是阻塞式的,所以支持栈空间/堆空间事件对象的发送(局部对象和new分配的对象)
new分配的事件对象被处理后,会由Qt内部自动摧毁

-非阻塞型事件发送

需要重写接收对象的event()事件处理函数
当事件发送后立即返回,事件将会发送到事件队列中等待处理
通过postEvent()静态函数实现非阻塞发送:

void QApplication::postEvent ( QObject * receiver, QEvent * event );

postEvent()函数是非阻塞式的,所以只能支持栈堆空间事件对象的发送(new分配的对象)
new分配的事件对象被处理后,会由Qt内部自动摧毁

示例-通过sendEvent()发送预定义的键盘Delete按键事件

Wiget.h

#ifndef WIDGET_H
#define WIDGET_H
#include <QWidget>
#include <QtGui>
class Widget : public QWidget
{
Q_OBJECT
private :
QTextEdit edit;
QPushButton bt;
private slots:
void onPushButton();
public:
explicit Widget();
};
#endif // WIDGET_H

Widget.c

#include "widget.h"
Widget::Widget() : edit(this),bt("Delete",this)
{
edit.setGeometry(,,,);
bt.setGeometry(,,,);
connect(&bt, SIGNAL(clicked()), this, SLOT(onPushButton()));
}
void Widget::onPushButton()
{
int key = Qt::Key_Delete ;
QKeyEvent EventPress(QEvent::KeyPress,key,Qt::NoModifier);
QApplication::sendEvent(&edit,&EventPress); //发送键盘按下事件
QKeyEvent EventRelease(QEvent::KeyRelease,key,Qt::NoModifier);
QApplication::sendEvent(&edit,&EventRelease); //发送键盘松开事件
}

效果

自定义事件对象

自定义的事件类必须继承自QEvent,并且无需指定父类
自定义的事件类必须拥有全局唯一的Type值,使用QEvent::User+value即可
自定义事件类示例:

class StringEvent : public QEvent
{
public：
static const Type = static_cast<Type>(QEvent::User+0x10);
explicit QStringEvent();
//... ...
}
QStringEvent::QStringEvent() :
QEvent(TYPE) //注册TYPE值
{
//... ...
}

由于Qt不认识自定义事件,所以程序里需要提供处理自定义事件对象的方法

常用两种方法来处理

1.通过事件过滤器处理

通过installEventFilter()安装到目标对象
在eventFilter()函数里处理事件

2.重写目标对象的event()函数

在event ()函数里处理事件

示例-通过单击鼠标按钮发送自定义事件QStringEvent

QStringEvent文件:

class QStringEvent : public QEvent
{
private:
QString mstr;
public:
const static Type TYPE = static_cast<Type>(QEvent::User+0x10);
explicit QStringEvent(QString s);
QString str();
};
QStringEvent::QStringEvent(QString s) :
QEvent(TYPE)
{
mstr = s;
}
QString QStringEvent::str()
{
return mstr;
}

widget文件:

class Widget : public QWidget
{
private :
QLabel label;
bool event( QEvent * e);
bool eventFilter(QObject *obj, QEvent *event);
public:
explicit Widget();
};
Widget::Widget() : label(this)
{
label.installEventFilter(this);
}
bool Widget::event( QEvent * e)
{
if(e->type() == QEvent::MouseButtonPress)
{
QMouseEvent *me = dynamic_cast<QMouseEvent* >(e);if(me->button() == Qt::LeftButton)
{
QStringEvent event( QString("X坐标: %1 Y坐标: %2").arg(me->x()).arg(me->y()) );
QApplication::sendEvent(&label,&event); //发送自定义事件
}
}
return QWidget::event(e);
}
bool Widget::eventFilter(QObject *obj, QEvent *event)
{
QLabel *t = dynamic_cast<QLabel* >(obj);
if(t && event->type()== QStringEvent::TYPE )
{
QStringEvent *str = dynamic_cast<QStringEvent* >(event);
t->setText(str->str());
t->adjustSize();
return true;
}
return QWidget::eventFilter(obj,event);
}

效果:

/***********************************************************************

Qt中的消息通知和事件发送

Qt中的信号和槽机制、事件机制是其具有特色的两大机制。利用这两种机制可以轻松地实现需要的消息通知和事件通知。

1、信号和槽机制

充分使用Qt库中已经定义和实现好的对象的信号和槽函数，如按钮的clicked()/pressed()信号等，它们能满足很多的需求；

自定义缺乏的信号和槽函数，借助Qt的元对象系统和内省机制，在创建类时添加Q_OBJECT宏，使用signals:/slots:标记添加自定义的信号/槽函数，使用时通过emit发送信号，用connect()函数连接信号和槽。

2、事件机制

充分使用Qt库中已经定义好的标准事件对象，如鼠标事件QMouseEvent、键盘事件QKeyPressEvent等，自定义实现事件的处理函数，如keyPressEvent(QEvent*)；

自定义需要的事件类型和实现QObject::customEvent(QEvent*)函数，使用Qt的postEvent和sendEvent函数发送事件通知。

(1)、自定义事件：

方式一；通过QEvent::Type指定事件类型的值，然后new一个该类型的自定义事件，如：

const QEvent::Type MyEvent = (QEvent::Type)9393;

QApplication::postEvent(object, new QCustomEvent(MyEvent));

【QCustomEvent类是Qt3中的类，现在已经不推荐使用了。】

QEvent::Type是Qt中的枚举类型，Qt定义了一大堆的库事件类型常数值，当然也允许用户自定义自己的事件类型值，但是自定义的值应大于1000(QEvent::User)，且小于65535(QEvent::MaxUser).方便起见，可以使用int QEvent::registerEventType ( int hint = -1 ) [static]函数注册和保留一个自定义的事件类型值，这样可以避免不小心重复使用了同一个事件类型值，它保证每次得到一个未被使用的事件类型常数值，该函数是线程安全的，在Qt4.4中引入。

方式二：通过继承QEvent创建新的事件类，如：

class CMyCustomEvent：public QEvent

{

public:

CMyCustomEvent(int data):m_iData(data),QEvent((QEvent::Type)9393){}

private:

int m_iData;

...

};

(2)、发送事件：postEvent/sendEvent/notify

postEvent函数：void QCoreApplication::postEvent ( QObject * receiver, QEvent * event ) [static]【异步】

将事件放入事件消息队列中，然后立即返回，函数只将事件放入队列的尾端，不保证事件立即得到处理。事件必须是分配在堆上的，即new出来的，因为在事件被发送出去后，事件队列就拥有了事件的，事件处理完后Qt会自动delete该事件，因此在把事件posted出去后再尝试使用它是不安全的。

当程序控制到达主事件循环时，事件队列中的所有事件才用notify函数发送。事件的处理是按照其发送到队列中的顺序进行的，如果想要控制事件的优先级，可以考虑它的带优先级参数的重载函数。

void QCoreApplication::postEvent ( QObject * receiver, QEvent * event, int priority ) [static]【Qt4.3引入】

这两个函数都是线程安全的。

sendEvent函数：bool QCoreApplication::sendEvent ( QObject * receiver, QEvent * event ) [static]【同步】

用notify函数将事件直接派发给接收者和进行处理，返回事件处理者的返回值。事件会立即送至接受者，被发送后，Qt不会自动delete该事件，因此合适的做法是在栈上创建事件。

sendPostedEvents：

void QCoreApplication::sendPostedEvents ( QObject * receiver, int event_type ) [static]

将事件队列中用postEvent函数放入的对应接受者和事件类型的事件立即分发，但是来自窗口系统的事件不被分发，它们被processEvents()函数分发。

如果接受者是null，则对应所有的接受者；如果event_type为0，则对应receiver的所有的事件。该函数必须和receiver在同一个线程内被调用。

void QCoreApplication::sendPostedEvents () [static]

分发事件队列中的所有事件，即清空事件队列。

notify：bool QCoreApplication::notify ( QObject * receiver, QEvent * event ) [virtual]

这是事件机制中最基本的函数，所有的事件发送最终都要调用这个函数。它把事件信号发送给接受者，并返回receiver->event(event)处理的返回值。

(3)、处理事件：void QObject::customEvent ( QEvent * event ) [virtual protected]

通过重载实现customEvent函数，可以对自定义的事件进行灵活的处理，如：

void MyWidget::customEvent(QEvent *event)

{

if (event->type() == MyCustomEvent)

{

QMessageBox msgBox;

msgBox.setText("The is mycustomevent example.");

msgBox.exec();

}

else if(...)

{

...

}

...

}
/***************************************************

1. sendEvent(QObject* receiver,QEvent* event)

使用notify()函数直接给receiver发送事件，也就是同步处理事件。

2. postEvent(QObject* receiver, QEvent* event)

向事件队列中添加receiver和event，对应异步处理事件。

3.QObject::customEvent(QEvent *e)

处理多个Qt事件处理函数，可以通过重载QObject::event()来实现。
/**************************************************************

Qt 自定义事件（三种方法：继承QEvent，然后Send Post就都可以了，也可以覆盖customEvent函数，也可覆盖event()函数）

Qt 自定义事件很简单，同其它类库的使用很相似，都是要继承一个类进行扩展。在 Qt 中，你需要继承的类是 QEvent。

继承QEvent类，你需要提供一个QEvent::Type类型的参数，作为自定义事件的类型值。这里的QEvent::Type类型是QEvent里面定义的一个enum，因此，你是可以传递一个int的。重要的是，你的事件类型不能和已经存在的type值重复，否则会有不可预料的错误发生！因为系统会将你的事件当做系统事件进行派发和调用。在Qt中，系统将保留0 - 999的值，也就是说，你的事件type要大于999. 具体来说，你的自定义事件的type要在QEvent::User和QEvent::MaxUser的范围之间。其中，QEvent::User值是1000，QEvent::MaxUser的值是65535。从这里知道，你最多可以定义64536个事件，相信这个数字已经足够大了！但是，即便如此，也只能保证用户自定义事件不能覆盖系统事件，并不能保证自定义事件之间不会被覆盖。为了解决这个问题，Qt提供了一个函数：registerEventType(),用于自定义事件的注册。该函数签名如下：

static int QEvent::registerEventType ( int hint = -1 );

函数是static的，因此可以使用QEvent类直接调用。函数接受一个int值，其默认值为-1，返回值是创建的这个Type类型的值。如果hint是合法的，不会发生任何覆盖，则会返回这个值；如果hint不合法，系统会自动分配一个合法值并返回。因此，使用这个函数即可完成type值的指定。这个函数是线程安全的，因此不必另外添加同步。

你可以在QEvent子类中添加自己的事件所需要的数据，然后进行事件的发送。Qt中提供了两种发送方式：

static bool QCoreApplication::sendEvent(QObjecy * receiver, QEvent * event)：事件被QCoreApplication的notify()函数直接发送给receiver对象，返回值是事件处理函数的返回值。使用这个函数必须要在栈上创建对象，例如：
```
QMouseEvent event(QEvent::MouseButtonPress, pos, 0, 0, 0);
QApplication::sendEvent(mainWindow, &event);
```
static bool QCoreApplication::postEvent(QObject * receiver, QEvent * event)：事件被QCoreApplication追加到事件列表的最后，并等待处理，该函数将事件追加后会立即返回，并且注意，该函数是线程安全的。另外一点是，使用这个函数必须要在堆上创建对象，例如：
```
QApplication::postEvent(object, new MyEvent(QEvent::registerEventType(2048)));
```
这个对象不需要手动delete，Qt会自动delete掉！因此，如果在post事件之后调用delete，程序可能会崩溃。另外，postEvent()函数还有一个重载的版本，增加一个优先级参数，具体请参见API。通过调用sendPostedEvent()函数可以让已提交的事件立即得到处理。

如果要处理自定义事件，可以重写QObject的customEvent()函数，该函数接收一个QEvent对象作为参数。注意，在Qt3中这个参数是QCustomEvent类型的。你可以像前面介绍的重写event()函数的方法去重写这个函数：

void CustomWidget::customEvent(QEvent *event) {
        CustomEvent *customEvent = static_cast<CustomEvent *>(event);
        // ....
}

另外，你也可以通过重写event()函数来处理自定义事件：

bool CustomWidget::event(QEvent *event) {
        if (event->type() == MyCustomEventType) {
                CustomEvent *myEvent = static_cast<CustomEvent *>(event);
                // processing...
                return true;
        }

        return QWidget::event(event);
}