【Qt】QObject详解

淩亂°似流年 2022-11-14 00:53 267阅读 0赞

00. 目录

文章目录

      1. 目录
      1. 概述
      1. 线程亲和性
      1. 没有拷贝构造函数或赋值运算符
      1. 自动连接
      1. 动态属性
      1. 国际化
      1. 属性文档
      1. 常用成员方法
      1. 附录

01. 概述

QObject类是所以Qt类的基类，也是Qt对象模型的核心。这个模型中的核心特性就是能让对象键无缝通信的信号和槽的机制。我们可以使用connect()函数将一个信号连接到一个槽上，也可以使用disconnect()删除这个连接。为了防止无休止的的信号通知，还可以使用blockSignals()来临时阻塞信号。而connectNotify()和disconnectNotify()两个函数可以让我们能够跟踪一个对象上信号的连接变化。

QObject对象使用对象树的方式来组织它们自己。所以，当你以另一个对象作为父来创建一个QObject对象时，该对象会自动的将它自己添加的父级的孩子列表中，父级会接管该对象的所有权，也就是说，父级会在自己的析构函数中自动释放它的所有孩子。我们可以使用对象名通过findChild()或findChildren()函数在对象树中查找一个或多个对象。

每一个QObject对象都有一个objectName()，并且它的类名也可以使用metaObject（）对象来获取。还可以使用inherits()来判断一个对象所属的类是否继承自另一个类。

当一个对象被销毁时，它会发出destroyed()信号。我们可以捕捉该信号来做一些最后的处理。

QObject对象可以使用event()函数来处理事件，还可以通过installEventFilter()和eventFilter()函数来过滤或拦截其他对象的事件。QObject还支持基本的定时器。

注意，对于所有实现信号、槽、或者属性的QObject对象来说**，Q_OBJECT宏**都是必须的。我们推荐在每一个QObject的子类中使用这个宏，无论其是否实现信号、槽或属性，这可以避免一些奇怪的行为。

Qt中，所有的控件都派生自QObject。而QObject中的isWidgetType()函数可以判断一个对象是否是一个控件。

QObject所有的成员方法：
在这里插入图片描述

02. 线程亲和性

QObject对象有一个线程亲和性，或者是它生存在某个特定的线程中。当一个QObject对象接收到一个queued signal或一个posted event时，相应的槽函数或事件处理器会在该对象所生存的线程中执行。

注意，如果一个线程没有线程亲和性，或者，如果它生存的线程没有运行事件循环，那么它不能接收到queued singal或posted event。

默认情况下，QObject对象生存在创建它的那个线程中。但我们可以使用thread()函数来查询对象的线程亲和性，还可以使用moveToThread()函数来改变一个对象的线程亲和性。并且，所有的对象都和它的父生存在同一个线程中。因此：

  • 在调用setParent()时，如果涉及到的两个对象不在同一个线程，就会失败。
  • 当一个QObject对象被移动到其他线程时，它们所有孩子也会自动被移动。
  • moveToThread()在对象有父级的时候，会失败
  • 如果一个QObject对象是在QThread::run()中被创建的，那么它们不能成为QThread对象的孩子，因为QThread对象并不生存在调用QThread::run()的那个线程中。

注意，一个QObject对象的成员变量不会自动成为该对象的孩子。对象间的父子关系必须通过向子对象的构造函数传递一个指针，或通过调用setParent()来实现。如果没有这样做，那么，当调用moveToThread()时，QObject对象的成员变量会仍然存在于老线程中。

03. 没有拷贝构造函数或赋值运算符

QObject对象既 没有拷贝构造函数也没有赋值运算符。实际上，它们在QObject类中都进行了声明，只不过是放在了private区域，并使用了Q_DISABLE_COPY()宏进行了禁用。这样一来，你应该在需要QObject子类作为值的地方，使用一个QObject指针来代替。例如，因为没有拷贝构造函数，你不能将QObject对象作为值存储到容器类中， 必须使用指针来存储。

04. 自动连接

Qt的元对象系统提供了一个自动连接信号和槽的机制。只要对象定义了合适的对象名，并且相应的槽函数的声明遵循移动的命名约定，那么就会在运行时通过QMetaObject::connectSlotsByName()函数来自动进行信号和槽的连接。我们在之前的例子中，经常使用的“转到槽…”操作，就通过这种机制实现的。

05. 动态属性

从Qt4.2开始，就可以在运行时动态的从QObject对象上添加或移除属性。动态属性不需要在编译时进行声明，但它们提供了和静态属性一样的效率，并使用同一套API进行操作，即使用property()函数来读取属性值，使用setProperty()函数来修改属性值。

而从Qt4.3开始，Qt Designer也支持了动态属性，并且Qt的标准控件和用户自定义的控件都可以被赋予动态属性。

06. 国际化

所有QObject的子类都支持Qt的翻译特性，也使我们可以把应用程序的用户界面翻译成不同的语言。而为了使用户可见的文本可以被翻译，我们必须使用tr()函数来将这些文本包围起来。

07. 属性文档

属性只有一个：objectName，类型是QString

相关成员方法

  1. QString objectName() const
  2.  void setObjectName(const QString &name)

08. 常用成员方法

  1. QObject::QObject(QObject *parent = nullptr)：构造函数
  2. 有一点注意，当控件的父对象为空时，这个控件就是一个顶层窗口控件。
  4. QObject::~QObject()：析构函数
  5. 当对象销毁时，所有和它相关的信号都回断开，相关的事件也会从事件队列中移除。建议使用deleteLater()来销毁对象，它比直接销毁delete更安全。
  6. 手册中有一个警告：删除所有子对象。如果这些对象中的任何一个在栈或全局上，则程序迟早会崩溃。
  7. 我的理解是：使用new在堆上分配空间来创建子对象，让父对象负责它的内存回收；如果要在栈上创建对象，就不要指定它的父对象，以免父对象回收了栈内存，导致崩溃。
  8. 不建议从父项外部保留指向子对象的指针。如果仍然这样做，则destroy()信号检测对象何时被销毁。
  10. 警告：等待传递挂起事件时删除QObject可能会导致崩溃。如果QObject存在于与当前正在执行的不同的线程中，则不能直接删除它。改为使用deleteLater（），这将导致事件循环在所有挂起事件传递给它之后删除该对象。 
  12. bool QObject::blockSignals(bool block)
  13. 当参数block=true时，该对象的信号被阻塞，即信号发不出去；除了destroy()信号。    
  15. const QObjectList＆QObject :: children（）const
  16. 返回子对象列表，QObjectList的定义：typedef QList < QObject * > QObjectList ;
  17. 列表第一个子项是最初添加的，最后一个子项是最后添加的；
  18. 在QWidget中的子项会因为提升函数raised()和降低lowered()，导致子项在列表中的变化，提升后子项将成为列表的最后一个，降低后会成为列表中最后一个。
  20. connect函数组
  21. QMetaObject::Connection QObject::connect(const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type = Qt::AutoConnection);
  23. QMetaObject::Connection QObject::connect(const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type = Qt::AutoConnection);
  25. QMetaObject::Connection QObject::connect(const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type = Qt::AutoConnection) const;
  27. QMetaObject::Connection QObject::connect(const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type = Qt::AutoConnection);
  29. QMetaObject::Connection QObject::connect(const QObject *sender, PointerToMemberFunction signal, Functor functor);
  31. QMetaObject::Connection QObject::connect(const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type = Qt::AutoConnection)
  33. disconnect
  34. void QObject :: dumpObjectInfo() const
  35. 将有关此对象的信号连接等的信息转储到调试输出。
  37. QList QObject::dynamicPropertyNames() const
  38. 返回使用setProperty()加载的属性列表。
  40. bool QObject::event(QEvent *e) [virtual]
  41. 此虚函数接收事件到对象，如果事件e被识别和处理，则应返回true 。可以重新实现event()函数以自定义对象的行为。
  42. 确保为所有未处理的事件调用父事件类实现。
  44. bool QObject::eventFilter(QObject *watched, QEvent *event) [virtual]
  45. 如果此对象执行installEventFilter安装为watched对象的事件过滤器，则过滤事件。
  46. 在重新实现此函数时，如果要过滤掉事件，即停止进一步处理，则返回true; 否则返回false。
  47. 警告：如果在此函数中删除接收器对象，请确保返回true。否则，Qt会将事件转发给已删除的对象，程序可能会崩溃。
  49. T QObject::findChild(const QString &name = QString(), Qt::FindChildOptions options = Qt::FindChildrenRecursively) const
  50. 返回找到第一个子项或孙子项；
  51. options取值：
  52. Qt::FindDirectChildrenOnly：只在子项中查找；
  53. Qt::FindChildrenRecursively：在所有项（包括孙子、重孙子等）中递归查找
  55. 如：返回parentWidget中名字为button1的QPushButton
  56. QPushButton *button = parentWidget->findChild<QPushButton *>("button1");
  58. QList QObject::findChildren(const QString &name = QString(), Qt::FindChildOptions options = Qt::FindChildrenRecursively) const
  59. 返回可以强制转换为T类型的给定name 的该对象的所有子项，如果没有找到，则返回空列表。
  60. 如：返回parentWidget中所有QPushButton子项：
  61. QList<QPushButton *> allPButtons = parentWidget.findChildren<QPushButton *>(); 
  63. QList QObject::findChildren(const QRegularExpression &re, Qt::FindChildOptions options = Qt::FindChildrenRecursively) const
  64. 上个函数的重载，可以使用正则表达来搜索子项。
  66. bool QObject::inherits(const char *className) const
  67. 判断一个类是不是继承子className
  68. QTimer *timer = new QTimer;         // QTimer 继承自 QObject
  69. timer->inherits("QTimer");          // 返回 true
  70. timer->inherits("QObject");         // 返回 true
  71. timer->inherits("QAbstractButton"); // 返回 false 
  73. void QObject::installEventFilter(QObject *filterObj)
  74. 在此该类上安装事件过滤器，即filterObj监视该类的事件发生。
  76. bool QObject::isWidgetType() const
  77. 如果该类继承自QWidget，则返回true，该函数比inherits(“QWidget”)快
  79. bool QObject::isWindowType() const
  80. 如果该类继承自QWindow，则返回true，该函数比inherits(“QWindow”)快
  82. void QObject::killTimer(int id)
  83. 使用计时器标识id来终止计时器；该标识id是int QObject::startTimer返回的。
  85. const QMetaObject *QObject::metaObject() const
  86. 返回指向该对象的元对象的指针。
  87. 元对象包含有关继承QObject的类的信息，例如类名，超类名，属性，信号和槽。包含Q_OBJECT宏的每个QObject子类都具有一个元对象。
  88. 实例代码如下，如果类没有实例化过，可以使用staticMetaObject来获取元对象信息：
  89. QObject *obj = new QPushButton;
  90. obj->metaObject()->className();             // returns "QPushButton"
  92. QPushButton::staticMetaObject.className();  // returns "QPushButton"
  94. void QObject::moveToThread(QThread *targetThread)
  95. 更改此对象及其子对象的线程关联。如果对象具有父对象，则无法移动该对象。事件处理将在targetThread中继续。
  97. QString objectName() const 和 void setObjectName(const QString &name)
  98. 设置对象名，默认是空；该名字在findChild和findChildren，即查找子项中使用。
  100. QObject *QObject::parent() const 和 void QObject::setParent(QObject *parent)
  101. 获取和设置父对象指针。
  103. QVariant QObject::property(const char *name) const
  104. 返回名字为name的属性值；
  106. bool QObject::setProperty(const char *name, const QVariant &value)
  107. 设置名字为name的属性值value；
  109. bool QObject::signalsBlocked() const
  110. 阻止该对象发送信号，可以暂停发送信号，默认不阻止；
  112. int QObject::startTimer(int interval, Qt::TimerType timerType = Qt::CoarseTimer)
  113. 启动计时器并返回计时器标识符，如果无法启动计时器，则返回零。
  114. 启动后，每次超时将会触发 timerEvent(QTimerEvent *event) 事件。
  115. 可以使用killTimer来终止计时。
  116. 当有多个计时器是，可以通过QTimerEvent::timerId() 获取计时器标识符来区别。
  117. 官方示例
  118. class MyObject : public QObject
  119. { 
  120.     Q_OBJECT
  122. public:
  123.     MyObject(QObject *parent = 0);
  125. protected:
  126.     void timerEvent(QTimerEvent *event) override;
  127. };
  129. MyObject::MyObject(QObject *parent)
  130.     : QObject(parent)
  131. { 
  132.     startTimer(50);     // 50-millisecond timer
  133.     startTimer(1000);   // 1-second timer
  134.     startTimer(60000);  // 1-minute timer
  136.     using namespace std::chrono;
  137.     startTimer(milliseconds(50));
  138.     startTimer(seconds(1));
  139.     startTimer(minutes(1));
  141.     // since C++14 we can use std::chrono::duration literals, e.g.:
  142.     //使用字面值
  143.     startTimer(100ms);
  144.     startTimer(5s);
  145.     startTimer(2min);
  146.     startTimer(1h);
  147. }
  149. void MyObject::timerEvent(QTimerEvent *event)
  150. { 
  151.     qDebug() << "Timer ID:" << event->timerId();
  152. }
  155. QThread *QObject::thread() const
  156. 返回对象所在的线程。

公有槽函数

  1. void QObject::deleteLater()
  2. 安全的删除对象，可以调用多次。

信号

  1. void QObject::destroyed(QObject *obj = nullptr) [signal]
  2. 该信号在对象obj被销毁之前立即发出，并且不能signalsBlocked函数阻挡。
  3. 发出此信号后，所有对象的子项都会立即被销毁。
  5. void QObject::objectNameChanged(const QString &objectName)
  6. 在更改对象名称后发出此信号。新对象名称作为objectName传递。
  7. 注意：这是一个private信号。它可以用于信号连接，但不能由用户发出。

受保护成员方法

  1. 大部分时虚函数，可以由用户来实现
  3. void QObject :: childEvent（QChildEvent * event）[virtual protected]
  4. 可以重新实现子项事件处理，包括添加子项事件、删除子项事件
  6. void QObject::connectNotify(const QMetaMethod &signal) [virtual protected]
  7. 当连接信号时，触发该函数；
  9. void QObject::disconnectNotify(const QMetaMethod &signal) [virtual protected]
  10. 当断开信号时，触发该函数；
  12. void QObject::customEvent(QEvent *event)
  13. 自定义事件
  15. bool QObject::isSignalConnected(const QMetaMethod &signal) const
  16. 如果signal信号已经连接，则返回true
  18. int QObject::receivers(const char *signal) const
  19. 返回连接到signal的接收者的数量。
  21. QObject * QObject::sender() const
  22. 返回发送者指针；
  23. 当与发送者不在同一个线程中，并使用Qt::DirectConnection时，此函数无效。
  25. int QObject::senderSignalIndex() const
  26. 发送信号索引
  28. void QObject::timerEvent(QTimerEvent *event)
  29. 计时器事件

宏定义

  1. QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
  2. Q_CLASSINFO(Name, Value)
  3. 此宏将额外信息与类关联，该类可使用QObject::metaObject()获得。仅在Active Qt，Qt D-Bus和Qt QML中使用
  5. Q_DISABLE_COPY(Class)
  6. 禁用给定Class的复制构造函数和赋值运算符。
  8. Q_EMIT
  9. 如果要将Qt信号和插槽与第三方信号/插槽机制一起使用，请使用此宏替换发射信号的关键字。
  11. Q_ENUM( …)
  12. 使用元对象系统注册枚举类型
  14. Q_ENUM_NS( …)
  15. 此宏使用元对象系统注册枚举类型。它必须放在具有Q_NAMESPACE宏的命名空间中的枚举声明之后。它与Q_ENUM相同，但在命名空间中。
  16. Q_FLAG( …)
  17. Q_FLAG_NS( …)
  18. Q_GADGET
  19. Q_INTERFACES( …)
  20. Q_INVOKABLE
  21. Q_NAMESPACE
  22. Q_OBJECT
  23. Q_PROPERTY( …)
  24. Q_REVISION
  25. Q_SET_OBJECT_NAME(Object)
  26. Q_SIGNAL
  27. Q_SIGNALS
  28. Q_SLOT
  29. Q_SLOTS

09. 附录

9.1 Qt教程汇总
网址：https://dengjin.blog.csdn.net/article/details/115174639

9.2 参考博客

网址：https://blog.csdn.net/Amnes1a/article/details/69371711

发表评论

表情：
评论列表 （有 0 条评论，267人围观）

还没有评论，来说两句吧...

相关阅读

    相关 NIO详解（五）：Buffer详解

    1. 概述 Java NIO中的Buffer用于和NIO通道进行交互。如你所知，数据是从通道读入缓冲区，从缓冲区写入到通道中的。缓冲区本质上是一块可以写入数据，然后可以从

    小咪咪小咪咪/ 0 赞/ 660 阅读