关于 QObject 类 1.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类提供了更高的接口。定时器事件作为参数传递

简述

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类提供了更高的接口。定时器事件作为参数传递

猜你喜欢

转载自www.cnblogs.com/yangjunhe460/p/10471246.html