/**************************************************************************** ** ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies). ** All rights reserved. ** Contact: Nokia Corporation (qt-info@nokia.com) ** ** This file is part of the QtCore module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** This file may be used under the terms of the GNU Lesser General Public ** License version 2.1 as published by the Free Software Foundation and ** appearing in the file LICENSE.LGPL included in the packaging of this ** file. Please review the following information to ensure the GNU Lesser ** General Public License version 2.1 requirements will be met: ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU General ** Public License version 3.0 as published by the Free Software Foundation ** and appearing in the file LICENSE.GPL included in the packaging of this ** file. Please review the following information to ensure the GNU General ** Public License version 3.0 requirements will be met: ** http://www.gnu.org/copyleft/gpl.html. ** ** Other Usage ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #ifndef QOBJECT_H #define QOBJECT_H #ifndef QT_NO_QOBJECT #include #include #include #include #ifdef QT_INCLUDE_COMPAT #include #endif #include QT_BEGIN_HEADER QT_BEGIN_NAMESPACE QT_MODULE(Core) class QEvent; class QTimerEvent; class QChildEvent; struct QMetaObject; class QVariant; class QObjectPrivate; class QObject; class QThread; class QWidget; #ifndef QT_NO_REGEXP class QRegExp; #endif #ifndef QT_NO_USERDATA class QObjectUserData; #endif typedef QList QObjectList; Q_CORE_EXPORT void qt_qFindChildren_helper(const QObject *parent, const QString &name, const QRegExp *re, const QMetaObject &mo, QList *list); Q_CORE_EXPORT QObject *qt_qFindChild_helper(const QObject *parent, const QString &name, const QMetaObject &mo); class #if defined(__INTEL_COMPILER) && defined(Q_OS_WIN) Q_CORE_EXPORT #endif QObjectData { public: virtual ~QObjectData() = 0; QObject *q_ptr; QObject *parent; QObjectList children; uint isWidget : 1; uint pendTimer : 1; uint blockSig : 1; uint wasDeleted : 1; uint ownObjectName : 1; uint sendChildEvents : 1; uint receiveChildEvents : 1; uint inEventHandler : 1; //only used if QT_JAMBI_BUILD uint inThreadChangeEvent : 1; uint hasGuards : 1; //true iff there is one or more QPointer attached to this object uint unused : 22; int postedEvents; QMetaObject *metaObject; // assert dynamic }; class Q_CORE_EXPORT QObject { Q_OBJECT Q_PROPERTY(QString objectName READ objectName WRITE setObjectName) Q_DECLARE_PRIVATE(QObject) public: Q_INVOKABLE explicit QObject(QObject *parent=0); virtual ~QObject(); virtual bool event(QEvent *); virtual bool eventFilter(QObject *, QEvent *); #ifdef qdoc static QString tr(const char *sourceText, const char *comment = 0, int n = -1); static QString trUtf8(const char *sourceText, const char *comment = 0, int n = -1); virtual const QMetaObject *metaObject() const; static const QMetaObject staticMetaObject; #endif #ifdef QT_NO_TRANSLATION static QString tr(const char *sourceText, const char *, int) { return QString::fromLatin1(sourceText); } static QString tr(const char *sourceText, const char * = 0) { return QString::fromLatin1(sourceText); } #ifndef QT_NO_TEXTCODEC static QString trUtf8(const char *sourceText, const char *, int) { return QString::fromUtf8(sourceText); } static QString trUtf8(const char *sourceText, const char * = 0) { return QString::fromUtf8(sourceText); } #endif #endif //QT_NO_TRANSLATION QString objectName() const; void setObjectName(const QString &name); inline bool isWidgetType() const { return d_ptr->isWidget; } inline bool signalsBlocked() const { return d_ptr->blockSig; } bool blockSignals(bool b); QThread *thread() const; void moveToThread(QThread *thread); int startTimer(int interval); void killTimer(int id); template inline T findChild(const QString &aName = QString()) const { return static_cast(qt_qFindChild_helper(this, aName, reinterpret_cast(0)->staticMetaObject)); } template inline QList findChildren(const QString &aName = QString()) const { QList list; union { QList *typedList; QList *voidList; } u; u.typedList = &list; qt_qFindChildren_helper(this, aName, 0, reinterpret_cast(0)->staticMetaObject, u.voidList); return list; } #ifndef QT_NO_REGEXP template inline QList findChildren(const QRegExp &re) const { QList list; union { QList *typedList; QList *voidList; } u; u.typedList = &list; qt_qFindChildren_helper(this, QString(), &re, reinterpret_cast(0)->staticMetaObject, u.voidList); return list; } #endif #ifdef QT3_SUPPORT QT3_SUPPORT QObject *child(const char *objName, const char *inheritsClass = 0, bool recursiveSearch = true) const; QT3_SUPPORT QObjectList queryList(const char *inheritsClass = 0, const char *objName = 0, bool regexpMatch = true, bool recursiveSearch = true) const; #endif inline const QObjectList &children() const { return d_ptr->children; } void setParent(QObject *); void installEventFilter(QObject *); void removeEventFilter(QObject *); static bool connect(const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType = #ifdef qdoc Qt::AutoConnection #else #ifdef QT3_SUPPORT Qt::AutoCompatConnection #else Qt::AutoConnection #endif #endif ); static bool connect(const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type = #ifdef qdoc Qt::AutoConnection #else #ifdef QT3_SUPPORT Qt::AutoCompatConnection #else Qt::AutoConnection #endif #endif ); inline bool connect(const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type = #ifdef qdoc Qt::AutoConnection #else #ifdef QT3_SUPPORT Qt::AutoCompatConnection #else Qt::AutoConnection #endif #endif ) const; static bool disconnect(const QObject *sender, const char *signal, const QObject *receiver, const char *member); static bool disconnect(const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member); inline bool disconnect(const char *signal = 0, const QObject *receiver = 0, const char *member = 0) { return disconnect(this, signal, receiver, member); } inline bool disconnect(const QObject *receiver, const char *member = 0) { return disconnect(this, 0, receiver, member); } void dumpObjectTree(); void dumpObjectInfo(); #ifndef QT_NO_PROPERTIES bool setProperty(const char *name, const QVariant &value); QVariant property(const char *name) const; QList dynamicPropertyNames() const; #endif // QT_NO_PROPERTIES #ifndef QT_NO_USERDATA static uint registerUserData(); void setUserData(uint id, QObjectUserData* data); QObjectUserData* userData(uint id) const; #endif // QT_NO_USERDATA Q_SIGNALS: void destroyed(QObject * = 0); public: inline QObject *parent() const { return d_ptr->parent; } inline bool inherits(const char *classname) const { return const_cast(this)->qt_metacast(classname) != 0; } public Q_SLOTS: void deleteLater(); protected: QObject *sender() const; int senderSignalIndex() const; int receivers(const char* signal) const; virtual void timerEvent(QTimerEvent *); virtual void childEvent(QChildEvent *); virtual void customEvent(QEvent *); virtual void connectNotify(const char *signal); virtual void disconnectNotify(const char *signal); #ifdef QT3_SUPPORT public: QT3_SUPPORT_CONSTRUCTOR QObject(QObject *parent, const char *name); inline QT3_SUPPORT void insertChild(QObject *o) { if (o) o->setParent(this); } inline QT3_SUPPORT void removeChild(QObject *o) { if (o) o->setParent(0); } inline QT3_SUPPORT bool isA(const char *classname) const { return qstrcmp(classname, metaObject()->className()) == 0; } inline QT3_SUPPORT const char *className() const { return metaObject()->className(); } inline QT3_SUPPORT const char *name() const { return objectName().latin1_helper(); } inline QT3_SUPPORT const char *name(const char *defaultName) const { QString s = objectName(); return s.isEmpty()?defaultName:s.latin1_helper(); } inline QT3_SUPPORT void setName(const char *aName) { setObjectName(QLatin1String(aName)); } protected: inline QT3_SUPPORT bool checkConnectArgs(const char *signal, const QObject *, const char *member) { return QMetaObject::checkConnectArgs(signal, member); } static inline QT3_SUPPORT QByteArray normalizeSignalSlot(const char *signalSlot) { return QMetaObject::normalizedSignature(signalSlot); } #endif protected: QObject(QObjectPrivate &dd, QObject *parent = 0); protected: QScopedPointer d_ptr; static const QMetaObject staticQtMetaObject; friend struct QMetaObject; friend class QApplication; friend class QApplicationPrivate; friend class QCoreApplication; friend class QCoreApplicationPrivate; friend class QWidget; friend class QThreadData; private: Q_DISABLE_COPY(QObject) Q_PRIVATE_SLOT(d_func(), void _q_reregisterTimers(void *)) }; inline bool QObject::connect(const QObject *asender, const char *asignal, const char *amember, Qt::ConnectionType atype) const { return connect(asender, asignal, this, amember, atype); } #ifndef QT_NO_USERDATA class Q_CORE_EXPORT QObjectUserData { public: virtual ~QObjectUserData(); }; #endif #ifdef qdoc T qFindChild(const QObject *o, const QString &name = QString()); QList qFindChildren(const QObject *oobj, const QString &name = QString()); QList qFindChildren(const QObject *o, const QRegExp &re); #endif #ifdef QT_DEPRECATED template inline QT_DEPRECATED T qFindChild(const QObject *o, const QString &name = QString()) { return o->findChild(name); } template inline QT_DEPRECATED QList qFindChildren(const QObject *o, const QString &name = QString()) { return o->findChildren(name); } #ifndef QT_NO_REGEXP template inline QT_DEPRECATED QList qFindChildren(const QObject *o, const QRegExp &re) { return o->findChildren(re); } #endif #endif //QT_DEPRECATED template inline T qobject_cast(QObject *object) { #if !defined(QT_NO_QOBJECT_CHECK) reinterpret_cast(object)->qt_check_for_QOBJECT_macro(*reinterpret_cast(object)); #endif return static_cast(reinterpret_cast(object)->staticMetaObject.cast(object)); } template inline T qobject_cast(const QObject *object) { #if !defined(QT_NO_QOBJECT_CHECK) reinterpret_cast(object)->qt_check_for_QOBJECT_macro(*reinterpret_cast(const_cast(object))); #endif return static_cast(reinterpret_cast(object)->staticMetaObject.cast(object)); } template inline const char * qobject_interface_iid() { return 0; } #ifndef Q_MOC_RUN # define Q_DECLARE_INTERFACE(IFace, IId) \ template <> inline const char *qobject_interface_iid() \ { return IId; } \ template <> inline IFace *qobject_cast(QObject *object) \ { return reinterpret_cast((object ? object->qt_metacast(IId) : 0)); } \ template <> inline IFace *qobject_cast(const QObject *object) \ { return reinterpret_cast((object ? const_cast(object)->qt_metacast(IId) : 0)); } #endif // Q_MOC_RUN #ifndef QT_NO_DEBUG_STREAM Q_CORE_EXPORT QDebug operator<<(QDebug, const QObject *); #endif QT_END_NAMESPACE QT_END_HEADER #endif #endif // QOBJECT_H