| 1 | /**************************************************************************** | 
|---|
| 2 | ** | 
|---|
| 3 | ** Copyright (C) 2020 The Qt Company Ltd. | 
|---|
| 4 | ** Copyright (C) 2013 Olivier Goffart <ogoffart@woboq.com> | 
|---|
| 5 | ** Contact: https://www.qt.io/licensing/ | 
|---|
| 6 | ** | 
|---|
| 7 | ** This file is part of the QtCore module of the Qt Toolkit. | 
|---|
| 8 | ** | 
|---|
| 9 | ** $QT_BEGIN_LICENSE:LGPL$ | 
|---|
| 10 | ** Commercial License Usage | 
|---|
| 11 | ** Licensees holding valid commercial Qt licenses may use this file in | 
|---|
| 12 | ** accordance with the commercial license agreement provided with the | 
|---|
| 13 | ** Software or, alternatively, in accordance with the terms contained in | 
|---|
| 14 | ** a written agreement between you and The Qt Company. For licensing terms | 
|---|
| 15 | ** and conditions see https://www.qt.io/terms-conditions. For further | 
|---|
| 16 | ** information use the contact form at https://www.qt.io/contact-us. | 
|---|
| 17 | ** | 
|---|
| 18 | ** GNU Lesser General Public License Usage | 
|---|
| 19 | ** Alternatively, this file may be used under the terms of the GNU Lesser | 
|---|
| 20 | ** General Public License version 3 as published by the Free Software | 
|---|
| 21 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | 
|---|
| 22 | ** packaging of this file. Please review the following information to | 
|---|
| 23 | ** ensure the GNU Lesser General Public License version 3 requirements | 
|---|
| 24 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | 
|---|
| 25 | ** | 
|---|
| 26 | ** GNU General Public License Usage | 
|---|
| 27 | ** Alternatively, this file may be used under the terms of the GNU | 
|---|
| 28 | ** General Public License version 2.0 or (at your option) the GNU General | 
|---|
| 29 | ** Public license version 3 or any later version approved by the KDE Free | 
|---|
| 30 | ** Qt Foundation. The licenses are as published by the Free Software | 
|---|
| 31 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | 
|---|
| 32 | ** included in the packaging of this file. Please review the following | 
|---|
| 33 | ** information to ensure the GNU General Public License requirements will | 
|---|
| 34 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | 
|---|
| 35 | ** https://www.gnu.org/licenses/gpl-3.0.html. | 
|---|
| 36 | ** | 
|---|
| 37 | ** $QT_END_LICENSE$ | 
|---|
| 38 | ** | 
|---|
| 39 | ****************************************************************************/ | 
|---|
| 40 |  | 
|---|
| 41 | #ifndef QOBJECT_H | 
|---|
| 42 | #define QOBJECT_H | 
|---|
| 43 |  | 
|---|
| 44 | #ifndef QT_NO_QOBJECT | 
|---|
| 45 |  | 
|---|
| 46 | #include <QtCore/qobjectdefs.h> | 
|---|
| 47 | #include <QtCore/qstring.h> | 
|---|
| 48 | #include <QtCore/qbytearray.h> | 
|---|
| 49 | #include <QtCore/qlist.h> | 
|---|
| 50 | #ifdef QT_INCLUDE_COMPAT | 
|---|
| 51 | #include <QtCore/qcoreevent.h> | 
|---|
| 52 | #endif | 
|---|
| 53 | #include <QtCore/qscopedpointer.h> | 
|---|
| 54 | #include <QtCore/qmetatype.h> | 
|---|
| 55 |  | 
|---|
| 56 | #include <QtCore/qobject_impl.h> | 
|---|
| 57 |  | 
|---|
| 58 | #if __has_include(<chrono>) | 
|---|
| 59 | #  include <chrono> | 
|---|
| 60 | #endif | 
|---|
| 61 |  | 
|---|
| 62 | QT_BEGIN_NAMESPACE | 
|---|
| 63 |  | 
|---|
| 64 |  | 
|---|
| 65 | class QBindingStorage; | 
|---|
| 66 | class QEvent; | 
|---|
| 67 | class QTimerEvent; | 
|---|
| 68 | class QChildEvent; | 
|---|
| 69 | struct QMetaObject; | 
|---|
| 70 | class QVariant; | 
|---|
| 71 | class QObjectPrivate; | 
|---|
| 72 | class QObject; | 
|---|
| 73 | class QThread; | 
|---|
| 74 | class QWidget; | 
|---|
| 75 | class QAccessibleWidget; | 
|---|
| 76 | #if QT_CONFIG(regularexpression) | 
|---|
| 77 | class QRegularExpression; | 
|---|
| 78 | #endif | 
|---|
| 79 | struct QDynamicMetaObjectData; | 
|---|
| 80 |  | 
|---|
| 81 | typedef QList<QObject*> QObjectList; | 
|---|
| 82 |  | 
|---|
| 83 | Q_CORE_EXPORT void qt_qFindChildren_helper(const QObject *parent, const QString &name, | 
|---|
| 84 | const QMetaObject &mo, QList<void *> *list, Qt::FindChildOptions options); | 
|---|
| 85 | Q_CORE_EXPORT void qt_qFindChildren_helper(const QObject *parent, const QRegularExpression &re, | 
|---|
| 86 | const QMetaObject &mo, QList<void *> *list, Qt::FindChildOptions options); | 
|---|
| 87 | Q_CORE_EXPORT QObject *qt_qFindChild_helper(const QObject *parent, const QString &name, const QMetaObject &mo, Qt::FindChildOptions options); | 
|---|
| 88 |  | 
|---|
| 89 | class Q_CORE_EXPORT QObjectData | 
|---|
| 90 | { | 
|---|
| 91 | Q_DISABLE_COPY(QObjectData) | 
|---|
| 92 | public: | 
|---|
| 93 | QObjectData() = default; | 
|---|
| 94 | virtual ~QObjectData() = 0; | 
|---|
| 95 | QObject *q_ptr; | 
|---|
| 96 | QObject *parent; | 
|---|
| 97 | QObjectList children; | 
|---|
| 98 |  | 
|---|
| 99 | uint isWidget : 1; | 
|---|
| 100 | uint blockSig : 1; | 
|---|
| 101 | uint wasDeleted : 1; | 
|---|
| 102 | uint isDeletingChildren : 1; | 
|---|
| 103 | uint sendChildEvents : 1; | 
|---|
| 104 | uint receiveChildEvents : 1; | 
|---|
| 105 | uint isWindow : 1; // for QWindow | 
|---|
| 106 | uint deleteLaterCalled : 1; | 
|---|
| 107 | uint unused : 24; | 
|---|
| 108 | int postedEvents; | 
|---|
| 109 | QDynamicMetaObjectData *metaObject; | 
|---|
| 110 | QMetaObject *dynamicMetaObject() const; | 
|---|
| 111 |  | 
|---|
| 112 | #ifdef QT_DEBUG | 
|---|
| 113 | enum { CheckForParentChildLoopsWarnDepth = 4096 }; | 
|---|
| 114 | #endif | 
|---|
| 115 | }; | 
|---|
| 116 |  | 
|---|
| 117 | class Q_CORE_EXPORT QObject | 
|---|
| 118 | { | 
|---|
| 119 | Q_OBJECT | 
|---|
| 120 |  | 
|---|
| 121 | Q_PROPERTY(QString objectName READ objectName WRITE setObjectName NOTIFY objectNameChanged) | 
|---|
| 122 | Q_DECLARE_PRIVATE(QObject) | 
|---|
| 123 |  | 
|---|
| 124 | public: | 
|---|
| 125 | Q_INVOKABLE explicit QObject(QObject *parent = nullptr); | 
|---|
| 126 | virtual ~QObject(); | 
|---|
| 127 |  | 
|---|
| 128 | virtual bool event(QEvent *event); | 
|---|
| 129 | virtual bool eventFilter(QObject *watched, QEvent *event); | 
|---|
| 130 |  | 
|---|
| 131 | #if defined(QT_NO_TRANSLATION) || defined(Q_CLANG_QDOC) | 
|---|
| 132 | static QString tr(const char *sourceText, const char * = nullptr, int = -1) | 
|---|
| 133 | { return QString::fromUtf8(sourceText); } | 
|---|
| 134 | #endif // QT_NO_TRANSLATION | 
|---|
| 135 |  | 
|---|
| 136 | QString objectName() const; | 
|---|
| 137 | void setObjectName(const QString &name); | 
|---|
| 138 |  | 
|---|
| 139 | inline bool isWidgetType() const { return d_ptr->isWidget; } | 
|---|
| 140 | inline bool isWindowType() const { return d_ptr->isWindow; } | 
|---|
| 141 |  | 
|---|
| 142 | inline bool signalsBlocked() const noexcept { return d_ptr->blockSig; } | 
|---|
| 143 | bool blockSignals(bool b) noexcept; | 
|---|
| 144 |  | 
|---|
| 145 | QThread *thread() const; | 
|---|
| 146 | void moveToThread(QThread *thread); | 
|---|
| 147 |  | 
|---|
| 148 | int startTimer(int interval, Qt::TimerType timerType = Qt::CoarseTimer); | 
|---|
| 149 | #if __has_include(<chrono>) | 
|---|
| 150 | Q_ALWAYS_INLINE | 
|---|
| 151 | int startTimer(std::chrono::milliseconds time, Qt::TimerType timerType = Qt::CoarseTimer) | 
|---|
| 152 | { | 
|---|
| 153 | return startTimer(int(time.count()), timerType); | 
|---|
| 154 | } | 
|---|
| 155 | #endif | 
|---|
| 156 | void killTimer(int id); | 
|---|
| 157 |  | 
|---|
| 158 | template<typename T> | 
|---|
| 159 | inline T findChild(const QString &aName = QString(), Qt::FindChildOptions options = Qt::FindChildrenRecursively) const | 
|---|
| 160 | { | 
|---|
| 161 | typedef typename std::remove_cv<typename std::remove_pointer<T>::type>::type ObjType; | 
|---|
| 162 | return static_cast<T>(qt_qFindChild_helper(this, aName, ObjType::staticMetaObject, options)); | 
|---|
| 163 | } | 
|---|
| 164 |  | 
|---|
| 165 | template<typename T> | 
|---|
| 166 | inline QList<T> findChildren(const QString &aName = QString(), Qt::FindChildOptions options = Qt::FindChildrenRecursively) const | 
|---|
| 167 | { | 
|---|
| 168 | typedef typename std::remove_cv<typename std::remove_pointer<T>::type>::type ObjType; | 
|---|
| 169 | QList<T> list; | 
|---|
| 170 | qt_qFindChildren_helper(this, aName, ObjType::staticMetaObject, | 
|---|
| 171 | reinterpret_cast<QList<void *> *>(&list), options); | 
|---|
| 172 | return list; | 
|---|
| 173 | } | 
|---|
| 174 |  | 
|---|
| 175 | #if QT_CONFIG(regularexpression) | 
|---|
| 176 | template<typename T> | 
|---|
| 177 | inline QList<T> findChildren(const QRegularExpression &re, Qt::FindChildOptions options = Qt::FindChildrenRecursively) const | 
|---|
| 178 | { | 
|---|
| 179 | typedef typename std::remove_cv<typename std::remove_pointer<T>::type>::type ObjType; | 
|---|
| 180 | QList<T> list; | 
|---|
| 181 | qt_qFindChildren_helper(this, re, ObjType::staticMetaObject, | 
|---|
| 182 | reinterpret_cast<QList<void *> *>(&list), options); | 
|---|
| 183 | return list; | 
|---|
| 184 | } | 
|---|
| 185 | #endif // QT_CONFIG(regularexpression) | 
|---|
| 186 |  | 
|---|
| 187 | inline const QObjectList &children() const { return d_ptr->children; } | 
|---|
| 188 |  | 
|---|
| 189 | void setParent(QObject *parent); | 
|---|
| 190 | void installEventFilter(QObject *filterObj); | 
|---|
| 191 | void removeEventFilter(QObject *obj); | 
|---|
| 192 |  | 
|---|
| 193 | static QMetaObject::Connection connect(const QObject *sender, const char *signal, | 
|---|
| 194 | const QObject *receiver, const char *member, Qt::ConnectionType = Qt::AutoConnection); | 
|---|
| 195 |  | 
|---|
| 196 | static QMetaObject::Connection connect(const QObject *sender, const QMetaMethod &signal, | 
|---|
| 197 | const QObject *receiver, const QMetaMethod &method, | 
|---|
| 198 | Qt::ConnectionType type = Qt::AutoConnection); | 
|---|
| 199 |  | 
|---|
| 200 | inline QMetaObject::Connection connect(const QObject *sender, const char *signal, | 
|---|
| 201 | const char *member, Qt::ConnectionType type = Qt::AutoConnection) const; | 
|---|
| 202 |  | 
|---|
| 203 | #ifdef Q_CLANG_QDOC | 
|---|
| 204 | template<typename PointerToMemberFunction> | 
|---|
| 205 | static QMetaObject::Connection connect(const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type = Qt::AutoConnection); | 
|---|
| 206 | template<typename PointerToMemberFunction, typename Functor> | 
|---|
| 207 | static QMetaObject::Connection connect(const QObject *sender, PointerToMemberFunction signal, Functor functor); | 
|---|
| 208 | template<typename PointerToMemberFunction, typename Functor> | 
|---|
| 209 | static QMetaObject::Connection connect(const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type = Qt::AutoConnection); | 
|---|
| 210 | #else | 
|---|
| 211 | //Connect a signal to a pointer to qobject member function | 
|---|
| 212 | template <typename Func1, typename Func2> | 
|---|
| 213 | static inline QMetaObject::Connection connect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, | 
|---|
| 214 | const typename QtPrivate::FunctionPointer<Func2>::Object *receiver, Func2 slot, | 
|---|
| 215 | Qt::ConnectionType type = Qt::AutoConnection) | 
|---|
| 216 | { | 
|---|
| 217 | typedef QtPrivate::FunctionPointer<Func1> SignalType; | 
|---|
| 218 | typedef QtPrivate::FunctionPointer<Func2> SlotType; | 
|---|
| 219 |  | 
|---|
| 220 | static_assert(QtPrivate::HasQ_OBJECT_Macro<typename SignalType::Object>::Value, | 
|---|
| 221 | "No Q_OBJECT in the class with the signal"); | 
|---|
| 222 |  | 
|---|
| 223 | //compilation error if the arguments does not match. | 
|---|
| 224 | static_assert(int(SignalType::ArgumentCount) >= int(SlotType::ArgumentCount), | 
|---|
| 225 | "The slot requires more arguments than the signal provides."); | 
|---|
| 226 | static_assert((QtPrivate::CheckCompatibleArguments<typename SignalType::Arguments, typename SlotType::Arguments>::value), | 
|---|
| 227 | "Signal and slot arguments are not compatible."); | 
|---|
| 228 | static_assert((QtPrivate::AreArgumentsCompatible<typename SlotType::ReturnType, typename SignalType::ReturnType>::value), | 
|---|
| 229 | "Return type of the slot is not compatible with the return type of the signal."); | 
|---|
| 230 |  | 
|---|
| 231 | const int *types = nullptr; | 
|---|
| 232 | if (type == Qt::QueuedConnection || type == Qt::BlockingQueuedConnection) | 
|---|
| 233 | types = QtPrivate::ConnectionTypes<typename SignalType::Arguments>::types(); | 
|---|
| 234 |  | 
|---|
| 235 | return connectImpl(sender, reinterpret_cast<void **>(&signal), | 
|---|
| 236 | receiver, reinterpret_cast<void **>(&slot), | 
|---|
| 237 | new QtPrivate::QSlotObject<Func2, typename QtPrivate::List_Left<typename SignalType::Arguments, SlotType::ArgumentCount>::Value, | 
|---|
| 238 | typename SignalType::ReturnType>(slot), | 
|---|
| 239 | type, types, &SignalType::Object::staticMetaObject); | 
|---|
| 240 | } | 
|---|
| 241 |  | 
|---|
| 242 | //connect to a function pointer  (not a member) | 
|---|
| 243 | template <typename Func1, typename Func2> | 
|---|
| 244 | static inline typename std::enable_if<int(QtPrivate::FunctionPointer<Func2>::ArgumentCount) >= 0, QMetaObject::Connection>::type | 
|---|
| 245 | connect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, Func2 slot) | 
|---|
| 246 | { | 
|---|
| 247 | return connect(sender, signal, sender, slot, Qt::DirectConnection); | 
|---|
| 248 | } | 
|---|
| 249 |  | 
|---|
| 250 | //connect to a function pointer  (not a member) | 
|---|
| 251 | template <typename Func1, typename Func2> | 
|---|
| 252 | static inline typename std::enable_if<int(QtPrivate::FunctionPointer<Func2>::ArgumentCount) >= 0 && | 
|---|
| 253 | !QtPrivate::FunctionPointer<Func2>::IsPointerToMemberFunction, QMetaObject::Connection>::type | 
|---|
| 254 | connect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, const QObject *context, Func2 slot, | 
|---|
| 255 | Qt::ConnectionType type = Qt::AutoConnection) | 
|---|
| 256 | { | 
|---|
| 257 | typedef QtPrivate::FunctionPointer<Func1> SignalType; | 
|---|
| 258 | typedef QtPrivate::FunctionPointer<Func2> SlotType; | 
|---|
| 259 |  | 
|---|
| 260 | static_assert(QtPrivate::HasQ_OBJECT_Macro<typename SignalType::Object>::Value, | 
|---|
| 261 | "No Q_OBJECT in the class with the signal"); | 
|---|
| 262 |  | 
|---|
| 263 | //compilation error if the arguments does not match. | 
|---|
| 264 | static_assert(int(SignalType::ArgumentCount) >= int(SlotType::ArgumentCount), | 
|---|
| 265 | "The slot requires more arguments than the signal provides."); | 
|---|
| 266 | static_assert((QtPrivate::CheckCompatibleArguments<typename SignalType::Arguments, typename SlotType::Arguments>::value), | 
|---|
| 267 | "Signal and slot arguments are not compatible."); | 
|---|
| 268 | static_assert((QtPrivate::AreArgumentsCompatible<typename SlotType::ReturnType, typename SignalType::ReturnType>::value), | 
|---|
| 269 | "Return type of the slot is not compatible with the return type of the signal."); | 
|---|
| 270 |  | 
|---|
| 271 | const int *types = nullptr; | 
|---|
| 272 | if (type == Qt::QueuedConnection || type == Qt::BlockingQueuedConnection) | 
|---|
| 273 | types = QtPrivate::ConnectionTypes<typename SignalType::Arguments>::types(); | 
|---|
| 274 |  | 
|---|
| 275 | return connectImpl(sender, reinterpret_cast<void **>(&signal), context, nullptr, | 
|---|
| 276 | new QtPrivate::QStaticSlotObject<Func2, | 
|---|
| 277 | typename QtPrivate::List_Left<typename SignalType::Arguments, SlotType::ArgumentCount>::Value, | 
|---|
| 278 | typename SignalType::ReturnType>(slot), | 
|---|
| 279 | type, types, &SignalType::Object::staticMetaObject); | 
|---|
| 280 | } | 
|---|
| 281 |  | 
|---|
| 282 | //connect to a functor | 
|---|
| 283 | template <typename Func1, typename Func2> | 
|---|
| 284 | static inline typename std::enable_if<QtPrivate::FunctionPointer<Func2>::ArgumentCount == -1, QMetaObject::Connection>::type | 
|---|
| 285 | connect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, Func2 slot) | 
|---|
| 286 | { | 
|---|
| 287 | return connect(sender, signal, sender, std::move(slot), Qt::DirectConnection); | 
|---|
| 288 | } | 
|---|
| 289 |  | 
|---|
| 290 | //connect to a functor, with a "context" object defining in which event loop is going to be executed | 
|---|
| 291 | template <typename Func1, typename Func2> | 
|---|
| 292 | static inline typename std::enable_if<QtPrivate::FunctionPointer<Func2>::ArgumentCount == -1, QMetaObject::Connection>::type | 
|---|
| 293 | connect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, const QObject *context, Func2 slot, | 
|---|
| 294 | Qt::ConnectionType type = Qt::AutoConnection) | 
|---|
| 295 | { | 
|---|
| 296 | typedef QtPrivate::FunctionPointer<Func1> SignalType; | 
|---|
| 297 | const int FunctorArgumentCount = QtPrivate::ComputeFunctorArgumentCount<Func2 , typename SignalType::Arguments>::Value; | 
|---|
| 298 |  | 
|---|
| 299 | static_assert((FunctorArgumentCount >= 0), | 
|---|
| 300 | "Signal and slot arguments are not compatible."); | 
|---|
| 301 | const int SlotArgumentCount = (FunctorArgumentCount >= 0) ? FunctorArgumentCount : 0; | 
|---|
| 302 | typedef typename QtPrivate::FunctorReturnType<Func2, typename QtPrivate::List_Left<typename SignalType::Arguments, SlotArgumentCount>::Value>::Value SlotReturnType; | 
|---|
| 303 |  | 
|---|
| 304 | static_assert((QtPrivate::AreArgumentsCompatible<SlotReturnType, typename SignalType::ReturnType>::value), | 
|---|
| 305 | "Return type of the slot is not compatible with the return type of the signal."); | 
|---|
| 306 |  | 
|---|
| 307 | static_assert(QtPrivate::HasQ_OBJECT_Macro<typename SignalType::Object>::Value, | 
|---|
| 308 | "No Q_OBJECT in the class with the signal"); | 
|---|
| 309 |  | 
|---|
| 310 | const int *types = nullptr; | 
|---|
| 311 | if (type == Qt::QueuedConnection || type == Qt::BlockingQueuedConnection) | 
|---|
| 312 | types = QtPrivate::ConnectionTypes<typename SignalType::Arguments>::types(); | 
|---|
| 313 |  | 
|---|
| 314 | return connectImpl(sender, reinterpret_cast<void **>(&signal), context, nullptr, | 
|---|
| 315 | new QtPrivate::QFunctorSlotObject<Func2, SlotArgumentCount, | 
|---|
| 316 | typename QtPrivate::List_Left<typename SignalType::Arguments, SlotArgumentCount>::Value, | 
|---|
| 317 | typename SignalType::ReturnType>(std::move(slot)), | 
|---|
| 318 | type, types, &SignalType::Object::staticMetaObject); | 
|---|
| 319 | } | 
|---|
| 320 | #endif //Q_CLANG_QDOC | 
|---|
| 321 |  | 
|---|
| 322 | static bool disconnect(const QObject *sender, const char *signal, | 
|---|
| 323 | const QObject *receiver, const char *member); | 
|---|
| 324 | static bool disconnect(const QObject *sender, const QMetaMethod &signal, | 
|---|
| 325 | const QObject *receiver, const QMetaMethod &member); | 
|---|
| 326 | inline bool disconnect(const char *signal = nullptr, | 
|---|
| 327 | const QObject *receiver = nullptr, const char *member = nullptr) const | 
|---|
| 328 | { return disconnect(this, signal, receiver, member); } | 
|---|
| 329 | inline bool disconnect(const QObject *receiver, const char *member = nullptr) const | 
|---|
| 330 | { return disconnect(this, nullptr, receiver, member); } | 
|---|
| 331 | static bool disconnect(const QMetaObject::Connection &); | 
|---|
| 332 |  | 
|---|
| 333 | #ifdef Q_CLANG_QDOC | 
|---|
| 334 | template<typename PointerToMemberFunction> | 
|---|
| 335 | static bool disconnect(const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method); | 
|---|
| 336 | #else | 
|---|
| 337 | template <typename Func1, typename Func2> | 
|---|
| 338 | static inline bool disconnect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, | 
|---|
| 339 | const typename QtPrivate::FunctionPointer<Func2>::Object *receiver, Func2 slot) | 
|---|
| 340 | { | 
|---|
| 341 | typedef QtPrivate::FunctionPointer<Func1> SignalType; | 
|---|
| 342 | typedef QtPrivate::FunctionPointer<Func2> SlotType; | 
|---|
| 343 |  | 
|---|
| 344 | static_assert(QtPrivate::HasQ_OBJECT_Macro<typename SignalType::Object>::Value, | 
|---|
| 345 | "No Q_OBJECT in the class with the signal"); | 
|---|
| 346 |  | 
|---|
| 347 | //compilation error if the arguments does not match. | 
|---|
| 348 | static_assert((QtPrivate::CheckCompatibleArguments<typename SignalType::Arguments, typename SlotType::Arguments>::value), | 
|---|
| 349 | "Signal and slot arguments are not compatible."); | 
|---|
| 350 |  | 
|---|
| 351 | return disconnectImpl(sender, reinterpret_cast<void **>(&signal), receiver, reinterpret_cast<void **>(&slot), | 
|---|
| 352 | &SignalType::Object::staticMetaObject); | 
|---|
| 353 | } | 
|---|
| 354 | template <typename Func1> | 
|---|
| 355 | static inline bool disconnect(const typename QtPrivate::FunctionPointer<Func1>::Object *sender, Func1 signal, | 
|---|
| 356 | const QObject *receiver, void **zero) | 
|---|
| 357 | { | 
|---|
| 358 | // This is the overload for when one wish to disconnect a signal from any slot. (slot=nullptr) | 
|---|
| 359 | // Since the function template parameter cannot be deduced from '0', we use a | 
|---|
| 360 | // dummy void ** parameter that must be equal to 0 | 
|---|
| 361 | Q_ASSERT(!zero); | 
|---|
| 362 | typedef QtPrivate::FunctionPointer<Func1> SignalType; | 
|---|
| 363 | return disconnectImpl(sender, reinterpret_cast<void **>(&signal), receiver, zero, | 
|---|
| 364 | &SignalType::Object::staticMetaObject); | 
|---|
| 365 | } | 
|---|
| 366 | #endif //Q_CLANG_QDOC | 
|---|
| 367 |  | 
|---|
| 368 | void dumpObjectTree() const; | 
|---|
| 369 | void dumpObjectInfo() const; | 
|---|
| 370 |  | 
|---|
| 371 | #ifndef QT_NO_PROPERTIES | 
|---|
| 372 | bool setProperty(const char *name, const QVariant &value); | 
|---|
| 373 | QVariant property(const char *name) const; | 
|---|
| 374 | QList<QByteArray> dynamicPropertyNames() const; | 
|---|
| 375 | QBindingStorage *bindingStorage(); | 
|---|
| 376 | const QBindingStorage *bindingStorage() const; | 
|---|
| 377 | #endif // QT_NO_PROPERTIES | 
|---|
| 378 |  | 
|---|
| 379 | Q_SIGNALS: | 
|---|
| 380 | void destroyed(QObject * = nullptr); | 
|---|
| 381 | void objectNameChanged(const QString &objectName, QPrivateSignal); | 
|---|
| 382 |  | 
|---|
| 383 | public: | 
|---|
| 384 | inline QObject *parent() const { return d_ptr->parent; } | 
|---|
| 385 |  | 
|---|
| 386 | inline bool inherits(const char *classname) const | 
|---|
| 387 | { | 
|---|
| 388 | return const_cast<QObject *>(this)->qt_metacast(classname) != nullptr; | 
|---|
| 389 | } | 
|---|
| 390 |  | 
|---|
| 391 | public Q_SLOTS: | 
|---|
| 392 | void deleteLater(); | 
|---|
| 393 |  | 
|---|
| 394 | protected: | 
|---|
| 395 | QObject *sender() const; | 
|---|
| 396 | int senderSignalIndex() const; | 
|---|
| 397 | int receivers(const char *signal) const; | 
|---|
| 398 | bool isSignalConnected(const QMetaMethod &signal) const; | 
|---|
| 399 |  | 
|---|
| 400 | virtual void timerEvent(QTimerEvent *event); | 
|---|
| 401 | virtual void childEvent(QChildEvent *event); | 
|---|
| 402 | virtual void customEvent(QEvent *event); | 
|---|
| 403 |  | 
|---|
| 404 | virtual void connectNotify(const QMetaMethod &signal); | 
|---|
| 405 | virtual void disconnectNotify(const QMetaMethod &signal); | 
|---|
| 406 |  | 
|---|
| 407 | protected: | 
|---|
| 408 | QObject(QObjectPrivate &dd, QObject *parent = nullptr); | 
|---|
| 409 |  | 
|---|
| 410 | protected: | 
|---|
| 411 | QScopedPointer<QObjectData> d_ptr; | 
|---|
| 412 |  | 
|---|
| 413 | friend struct QMetaObject; | 
|---|
| 414 | friend struct QMetaObjectPrivate; | 
|---|
| 415 | friend class QMetaCallEvent; | 
|---|
| 416 | friend class QApplication; | 
|---|
| 417 | friend class QApplicationPrivate; | 
|---|
| 418 | friend class QCoreApplication; | 
|---|
| 419 | friend class QCoreApplicationPrivate; | 
|---|
| 420 | friend class QWidget; | 
|---|
| 421 | friend class QAccessibleWidget; | 
|---|
| 422 | friend class QThreadData; | 
|---|
| 423 |  | 
|---|
| 424 | private: | 
|---|
| 425 | Q_DISABLE_COPY(QObject) | 
|---|
| 426 | Q_PRIVATE_SLOT(d_func(), void _q_reregisterTimers(void *)) | 
|---|
| 427 |  | 
|---|
| 428 | private: | 
|---|
| 429 | static QMetaObject::Connection connectImpl(const QObject *sender, void **signal, | 
|---|
| 430 | const QObject *receiver, void **slotPtr, | 
|---|
| 431 | QtPrivate::QSlotObjectBase *slot, Qt::ConnectionType type, | 
|---|
| 432 | const int *types, const QMetaObject *senderMetaObject); | 
|---|
| 433 |  | 
|---|
| 434 | static bool disconnectImpl(const QObject *sender, void **signal, const QObject *receiver, void **slot, | 
|---|
| 435 | const QMetaObject *senderMetaObject); | 
|---|
| 436 |  | 
|---|
| 437 | }; | 
|---|
| 438 |  | 
|---|
| 439 | inline QMetaObject::Connection QObject::connect(const QObject *asender, const char *asignal, | 
|---|
| 440 | const char *amember, Qt::ConnectionType atype) const | 
|---|
| 441 | { return connect(asender, asignal, this, amember, atype); } | 
|---|
| 442 |  | 
|---|
| 443 | template <class T> | 
|---|
| 444 | inline T qobject_cast(QObject *object) | 
|---|
| 445 | { | 
|---|
| 446 | typedef typename std::remove_cv<typename std::remove_pointer<T>::type>::type ObjType; | 
|---|
| 447 | static_assert(QtPrivate::HasQ_OBJECT_Macro<ObjType>::Value, | 
|---|
| 448 | "qobject_cast requires the type to have a Q_OBJECT macro"); | 
|---|
| 449 | return static_cast<T>(ObjType::staticMetaObject.cast(object)); | 
|---|
| 450 | } | 
|---|
| 451 |  | 
|---|
| 452 | template <class T> | 
|---|
| 453 | inline T qobject_cast(const QObject *object) | 
|---|
| 454 | { | 
|---|
| 455 | typedef typename std::remove_cv<typename std::remove_pointer<T>::type>::type ObjType; | 
|---|
| 456 | static_assert(QtPrivate::HasQ_OBJECT_Macro<ObjType>::Value, | 
|---|
| 457 | "qobject_cast requires the type to have a Q_OBJECT macro"); | 
|---|
| 458 | return static_cast<T>(ObjType::staticMetaObject.cast(object)); | 
|---|
| 459 | } | 
|---|
| 460 |  | 
|---|
| 461 |  | 
|---|
| 462 | template <class T> inline const char * qobject_interface_iid() | 
|---|
| 463 | { return nullptr; } | 
|---|
| 464 |  | 
|---|
| 465 | inline const QBindingStorage *qGetBindingStorage(const QObject *o) | 
|---|
| 466 | { | 
|---|
| 467 | return o->bindingStorage(); | 
|---|
| 468 | } | 
|---|
| 469 | inline QBindingStorage *qGetBindingStorage(QObject *o) | 
|---|
| 470 | { | 
|---|
| 471 | return o->bindingStorage(); | 
|---|
| 472 | } | 
|---|
| 473 |  | 
|---|
| 474 | #if defined(Q_CLANG_QDOC) | 
|---|
| 475 | #  define Q_DECLARE_INTERFACE(IFace, IId) | 
|---|
| 476 | #elif !defined(Q_MOC_RUN) | 
|---|
| 477 | #  define Q_DECLARE_INTERFACE(IFace, IId) \ | 
|---|
| 478 | template <> inline const char *qobject_interface_iid<IFace *>() \ | 
|---|
| 479 | { return IId; } \ | 
|---|
| 480 | template <> inline IFace *qobject_cast<IFace *>(QObject *object) \ | 
|---|
| 481 | { return reinterpret_cast<IFace *>((object ? object->qt_metacast(IId) : nullptr)); } \ | 
|---|
| 482 | template <> inline IFace *qobject_cast<IFace *>(const QObject *object) \ | 
|---|
| 483 | { return reinterpret_cast<IFace *>((object ? const_cast<QObject *>(object)->qt_metacast(IId) : nullptr)); } | 
|---|
| 484 | #endif // Q_MOC_RUN | 
|---|
| 485 |  | 
|---|
| 486 | #ifndef QT_NO_DEBUG_STREAM | 
|---|
| 487 | Q_CORE_EXPORT QDebug operator<<(QDebug, const QObject *); | 
|---|
| 488 | #endif | 
|---|
| 489 |  | 
|---|
| 490 | class QSignalBlocker | 
|---|
| 491 | { | 
|---|
| 492 | public: | 
|---|
| 493 | inline explicit QSignalBlocker(QObject *o) noexcept; | 
|---|
| 494 | inline explicit QSignalBlocker(QObject &o) noexcept; | 
|---|
| 495 | inline ~QSignalBlocker(); | 
|---|
| 496 |  | 
|---|
| 497 | inline QSignalBlocker(QSignalBlocker &&other) noexcept; | 
|---|
| 498 | inline QSignalBlocker &operator=(QSignalBlocker &&other) noexcept; | 
|---|
| 499 |  | 
|---|
| 500 | inline void reblock() noexcept; | 
|---|
| 501 | inline void unblock() noexcept; | 
|---|
| 502 |  | 
|---|
| 503 | private: | 
|---|
| 504 | Q_DISABLE_COPY(QSignalBlocker) | 
|---|
| 505 | QObject *m_o; | 
|---|
| 506 | bool m_blocked; | 
|---|
| 507 | bool m_inhibited; | 
|---|
| 508 | }; | 
|---|
| 509 |  | 
|---|
| 510 | QSignalBlocker::QSignalBlocker(QObject *o) noexcept | 
|---|
| 511 | : m_o(o), | 
|---|
| 512 | m_blocked(o && o->blockSignals(true)), | 
|---|
| 513 | m_inhibited(false) | 
|---|
| 514 | {} | 
|---|
| 515 |  | 
|---|
| 516 | QSignalBlocker::QSignalBlocker(QObject &o) noexcept | 
|---|
| 517 | : m_o(&o), | 
|---|
| 518 | m_blocked(o.blockSignals(true)), | 
|---|
| 519 | m_inhibited(false) | 
|---|
| 520 | {} | 
|---|
| 521 |  | 
|---|
| 522 | QSignalBlocker::QSignalBlocker(QSignalBlocker &&other) noexcept | 
|---|
| 523 | : m_o(other.m_o), | 
|---|
| 524 | m_blocked(other.m_blocked), | 
|---|
| 525 | m_inhibited(other.m_inhibited) | 
|---|
| 526 | { | 
|---|
| 527 | other.m_o = nullptr; | 
|---|
| 528 | } | 
|---|
| 529 |  | 
|---|
| 530 | QSignalBlocker &QSignalBlocker::operator=(QSignalBlocker &&other) noexcept | 
|---|
| 531 | { | 
|---|
| 532 | if (this != &other) { | 
|---|
| 533 | // if both *this and other block the same object's signals: | 
|---|
| 534 | // unblock *this iff our dtor would unblock, but other's wouldn't | 
|---|
| 535 | if (m_o != other.m_o || (!m_inhibited && other.m_inhibited)) | 
|---|
| 536 | unblock(); | 
|---|
| 537 | m_o = other.m_o; | 
|---|
| 538 | m_blocked = other.m_blocked; | 
|---|
| 539 | m_inhibited = other.m_inhibited; | 
|---|
| 540 | // disable other: | 
|---|
| 541 | other.m_o = nullptr; | 
|---|
| 542 | } | 
|---|
| 543 | return *this; | 
|---|
| 544 | } | 
|---|
| 545 |  | 
|---|
| 546 | QSignalBlocker::~QSignalBlocker() | 
|---|
| 547 | { | 
|---|
| 548 | if (m_o && !m_inhibited) | 
|---|
| 549 | m_o->blockSignals(m_blocked); | 
|---|
| 550 | } | 
|---|
| 551 |  | 
|---|
| 552 | void QSignalBlocker::reblock() noexcept | 
|---|
| 553 | { | 
|---|
| 554 | if (m_o) | 
|---|
| 555 | m_o->blockSignals(true); | 
|---|
| 556 | m_inhibited = false; | 
|---|
| 557 | } | 
|---|
| 558 |  | 
|---|
| 559 | void QSignalBlocker::unblock() noexcept | 
|---|
| 560 | { | 
|---|
| 561 | if (m_o) | 
|---|
| 562 | m_o->blockSignals(m_blocked); | 
|---|
| 563 | m_inhibited = true; | 
|---|
| 564 | } | 
|---|
| 565 |  | 
|---|
| 566 | namespace QtPrivate { | 
|---|
| 567 | inline QObject & deref_for_methodcall(QObject &o) { return  o; } | 
|---|
| 568 | inline QObject & deref_for_methodcall(QObject *o) { return *o; } | 
|---|
| 569 | } | 
|---|
| 570 | #define Q_SET_OBJECT_NAME(obj) QT_PREPEND_NAMESPACE(QtPrivate)::deref_for_methodcall(obj).setObjectName(QLatin1String(#obj)) | 
|---|
| 571 |  | 
|---|
| 572 | QT_END_NAMESPACE | 
|---|
| 573 |  | 
|---|
| 574 | #endif | 
|---|
| 575 |  | 
|---|
| 576 | #endif // QOBJECT_H | 
|---|
| 577 |  | 
|---|