关于 QObject 类
1.QObject类
简述
QObject类是所有Qt对象的基类。
QObject是Qt对象模型的核心。 该模型的核心特征是称为信号和槽的对象通信机制。 您可以使用connect()将信号连接到槽,并用disconnect()终止该连接。为了避免信号死循环,你可以调用blockSignals()去终止该对象的信号发射。 保护类型函数connectNotify()和disconnectNotify()可以跟踪连接。
QObjects对象在树结构中组织起来。当你创建一个QObject对象,以另一个对象作为父对象时,该对象将自动添加到父对象的children()列表中。父类对象拥有子类对象的所有权,即它将在析构函数中自动删除子类对象。你可以通过findChild()或者findChildren()函数由名称或者类型查找对象。
每个对象都有一个objectName(),对象的类名也可以通过metaObject::className()获得。你可以用inherits()函数来判断对象是否继承自另外一个类。
当一个对象被删除时,它会发出一个destroy()信号。 您可以捕获此信号,以避免对空指针的引用。
QObjects可以通过event()接收事件,也可以过滤其他对象的事件。 有关详细信息,请参阅installEventFilter()和eventFilter()。
事件在创建对象的线程中传递。请注意,对于没有线程亲和性(thread()返回零)的QObject,完全不执行事件处理。使用moveToThread()函数来更改对象及其子对象的线程亲和性(如果对象具有父对象则不能被移动)。
请注意,对于实现信号和槽机制或动态对象属性,Q_OBJECT宏是必需的。你需要在源文件上运行元对象编译器。我们强烈建议在QObject的所有子类中使用此宏。无论是否使用了信号和槽机制,这样做避免一些奇怪的行为。
所有Qt Widget都继承QObject。一个方便的函数isWidgetType()返回一个对象是否是一个Widget。它比qobject_cast <QWidget *>(obj)或obj->inherits("")快很多。
私有属性
objectName : QString
这个属性表示对象的名称,可以用过 objectName()获取和setObjectName()设置对象的名称。
信号
void QObject::destroyed(QObject *obj = 0) [signal]
这个信号在对象被销毁之前发射,并且不能被阻塞。当这个对象销毁时,其子类对象也跟着销毁。
槽
void QObject::deleteLater() [slot]
安排对象的销毁。
当程序返回到创建该对象的消息循环时,删除该对象。如果调用该函数时,消息循环未运行(例如在 QCoreApplication::exec() 之前对对象调用deleteLater()),则在消息循环启动之后,该对象被删除。如果在主消息循环结束之后调用deleteLater()函数,则不会删除该对象。自从Qt4.8,没有消息循环的线程中的对象调用deleteLater(), 则在线
程结束后,该对象被销毁。
请注意,进入和离开新的消息循环(例如,打开一个模态对话框),将不执行延迟删除。对于要删除的对象,程序必须返回到调用deleteLater()的消息循环。
注意:多次调用该函数是安全的,因为当第一个延迟删除函数触发时,该对象的挂起事件都要从消息队列中删除。
函数
A.static function
1.bool QObejct::connect(const QObejct* sender, const char* signal, const QObject* receiver, const char* method, Qt::ConnectionType type =
Qt::AutoConnection) [static]
这个是我们最常见的用来连接信号和槽的函数。如果连接成功返回true,连接失败返回false。
2.bool QObject::connect(const QObejct* sender, const QMetaMethod & signal, const QObject* receiver, const QMetaMethod & method, Qt::ConnectionType type = Qt::AutoConnection) [static]
Qt中QMetaMethod,元方法类,告诉我们这个方法的很多元信息(比如signature(),parameterTypes(),parameterNames())。判断一个方法是否是元方法
a:元对象系统中(声明了Q_Obejct宏),一个类中的信号或者槽函数都是元函数。
b: 用Q_INVOKABLE宏声明,构造函数也用Q_INVOKABLE宏注册。
3.bool QObject::disconnect(const QObejct* sender, const char* signal, const QObject* receiver, const char* method)
如果信号和槽断开返回true,否则返回false。
4.bool QObject::disconnect(const QObejct* sender, const QMetaMethod & signal, const QObject* receiver, const QMetaMethod & method)
如果信号和槽断开返回true,否则返回false。
5.const QMeteObject QObject::staticMetaObject
静态变量储存了这个类的元对象。
举例 QPushButton::staticMetaObject.className() // return "QPushButton"
6.QString QObject::tr(const char *sourceText, const char *disambiguation = 0, int n = -1) [static]
B.protected function
1.void QObject::childEvent(QChildEvent *event) [virtual protected]
这个事件处理函数能在子类重写,来接收子类的事件。参数就是当前事件。
在添加和删除子类对象时,QEvent::ChildAdded和QEvent::ChildRemoved事件发送给对象(QEvent::ChildAdded和QEvent::ChildRemoved都是QEvent::Type类型,表示一个事件)。在这两种情况下,你只能指望子类对象是QObject或者QWidgt类型(因为ChildAdded时,子类对象并未完全构造。在ChildRemoved时,子类对象已经被破坏)。
QEvent::ChildPolished事件发送给窗口,当子类对象被抛光或者抛光的子类对象被添加时。当你接收到抛光事件时,子类对象一般是完全构造好了的,但是这也不能确定。
因为在子类对象构造时,你可能接受到很多的抛光事件。
对于child widget,你总是能接收到一个ChildAdded事件,零个或多个ChildPolished事件,一个ChildRemoved事件。
ChildPolished事件被忽略,当一个对象添加后马上删除。如果一个子类对象在构造和析构时,被抛光几次。你可能接收到同一个子类对象几次的抛光事件。
2.void QObject::connectNotify(const char * signal) [virtual protected]
对象中的信号,连接到某东西时。该函数被调用。
如果你想比较函数中的参数和一个实际信号。使用QLatin1String()函数和SIGNAL()宏。
if(QLatin1String(signal) == SIGNAL(valueChanged(int))) 比较参数是否是valueChanged(int)信号?
如果信号包含多个参数或者空格参数,在SIGNAL()宏的结果上调用QMetaObject::normalizedSignature()函数。
3.void QObject::customEvent(QEvent *event) [virtual protected]
该事件处理程序能在子类中重写,来接收自定义事件。自定义的事件要大于QEvent::User(QEvent::User值是1000)。事件被作为参数随函数传递。
4.void QObject::disconnectNotify(const char * signal) [virtual protected]
当信号连接到的某个槽断开时,调用该虚函数。
5.int QObject::receivers(const char * signal) const [protected]
返回信号的连接数。
6.QObject * QObject::sender() const [protected]
返回对象的指针。信号连接到槽,在槽中调用该函数,返回发射信号的对象的指针。注意:只有在槽中该函数才有用,其他情况下,返回值是0。
7.int QObject::senderSignalIndex() const [protected]
返回信号这个函数的原函数索引。只有在槽中调用才返回正常值,在其他地方调用返回-1。
无论信号是否有参数,该函数总返回带参数的信号索引。当你对信号重载时,该方法明显不适用。
8.void QObject::timerEvent(QTimerEvent *event) [virtual protected]
这个事件处理函数能在子类重写,以接收子类的定时器事件。
QTimer类提供了更高的接口。定时器事件作为参数传递