| 1 | /**************************************************************************** | 
|---|
| 2 | ** $Id: qobject.h 2 2005-11-16 15:49:26Z dmik $ | 
|---|
| 3 | ** | 
|---|
| 4 | ** Definition of QObject class | 
|---|
| 5 | ** | 
|---|
| 6 | ** Created : 930418 | 
|---|
| 7 | ** | 
|---|
| 8 | ** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved. | 
|---|
| 9 | ** | 
|---|
| 10 | ** This file is part of the kernel module of the Qt GUI Toolkit. | 
|---|
| 11 | ** | 
|---|
| 12 | ** This file may be distributed under the terms of the Q Public License | 
|---|
| 13 | ** as defined by Trolltech AS of Norway and appearing in the file | 
|---|
| 14 | ** LICENSE.QPL included in the packaging of this file. | 
|---|
| 15 | ** | 
|---|
| 16 | ** This file may be distributed and/or modified under the terms of the | 
|---|
| 17 | ** GNU General Public License version 2 as published by the Free Software | 
|---|
| 18 | ** Foundation and appearing in the file LICENSE.GPL included in the | 
|---|
| 19 | ** packaging of this file. | 
|---|
| 20 | ** | 
|---|
| 21 | ** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition | 
|---|
| 22 | ** licenses may use this file in accordance with the Qt Commercial License | 
|---|
| 23 | ** Agreement provided with the Software. | 
|---|
| 24 | ** | 
|---|
| 25 | ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE | 
|---|
| 26 | ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. | 
|---|
| 27 | ** | 
|---|
| 28 | ** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for | 
|---|
| 29 | **   information about Qt Commercial License Agreements. | 
|---|
| 30 | ** See http://www.trolltech.com/qpl/ for QPL licensing information. | 
|---|
| 31 | ** See http://www.trolltech.com/gpl/ for GPL licensing information. | 
|---|
| 32 | ** | 
|---|
| 33 | ** Contact info@trolltech.com if any conditions of this licensing are | 
|---|
| 34 | ** not clear to you. | 
|---|
| 35 | ** | 
|---|
| 36 | **********************************************************************/ | 
|---|
| 37 |  | 
|---|
| 38 | #ifndef QOBJECT_H | 
|---|
| 39 | #define QOBJECT_H | 
|---|
| 40 |  | 
|---|
| 41 | #ifndef QT_H | 
|---|
| 42 | #include "qobjectdefs.h" | 
|---|
| 43 | #include "qwindowdefs.h" | 
|---|
| 44 | #include "qstring.h" | 
|---|
| 45 | #include "qevent.h" | 
|---|
| 46 | #include "qnamespace.h" | 
|---|
| 47 | #endif // QT_H | 
|---|
| 48 |  | 
|---|
| 49 | #define QT_TR_NOOP(x) (x) | 
|---|
| 50 | #define QT_TRANSLATE_NOOP(scope,x) (x) | 
|---|
| 51 |  | 
|---|
| 52 | class QMetaObject; | 
|---|
| 53 | class QVariant; | 
|---|
| 54 | class QMetaProperty; | 
|---|
| 55 | class QPostEventList; | 
|---|
| 56 | class QSenderObjectList; | 
|---|
| 57 | class QObjectPrivate; | 
|---|
| 58 | #ifndef QT_NO_USERDATA | 
|---|
| 59 | class QObjectUserData; | 
|---|
| 60 | #endif | 
|---|
| 61 | struct QUObject; | 
|---|
| 62 |  | 
|---|
| 63 | class Q_EXPORT QObject: public Qt | 
|---|
| 64 | { | 
|---|
| 65 | Q_OBJECT | 
|---|
| 66 | Q_PROPERTY( QCString name READ name WRITE setName ) | 
|---|
| 67 |  | 
|---|
| 68 | public: | 
|---|
| 69 | QObject( QObject *parent=0, const char *name=0 ); | 
|---|
| 70 | virtual ~QObject(); | 
|---|
| 71 |  | 
|---|
| 72 | #ifdef Q_QDOC | 
|---|
| 73 | virtual const char *className() const; | 
|---|
| 74 | static QString tr( const char *, const char * ); | 
|---|
| 75 | static QString trUtf8( const char *, const char * ); | 
|---|
| 76 | virtual QMetaObject *metaObject() const; | 
|---|
| 77 | #endif | 
|---|
| 78 |  | 
|---|
| 79 | virtual bool event( QEvent * ); | 
|---|
| 80 | virtual bool eventFilter( QObject *, QEvent * ); | 
|---|
| 81 |  | 
|---|
| 82 | bool         isA( const char * )     const; | 
|---|
| 83 | bool         inherits( const char * ) const; | 
|---|
| 84 |  | 
|---|
| 85 | const char  *name() const; | 
|---|
| 86 | const char  *name( const char * defaultName ) const; | 
|---|
| 87 |  | 
|---|
| 88 | virtual void setName( const char *name ); | 
|---|
| 89 | bool         isWidgetType()   const { return isWidget; } | 
|---|
| 90 | bool         highPriority()   const { return FALSE; } | 
|---|
| 91 |  | 
|---|
| 92 | bool         signalsBlocked()  const { return blockSig; } | 
|---|
| 93 | void         blockSignals( bool b ); | 
|---|
| 94 |  | 
|---|
| 95 | int          startTimer( int interval ); | 
|---|
| 96 | void         killTimer( int id ); | 
|---|
| 97 | void         killTimers(); | 
|---|
| 98 |  | 
|---|
| 99 | QObject           *child( const char *objName, const char *inheritsClass = 0, bool recursiveSearch = TRUE ); //### const in 4.0 | 
|---|
| 100 | const QObjectList *children() const { return childObjects; } | 
|---|
| 101 |  | 
|---|
| 102 | static const QObjectList *objectTrees(); | 
|---|
| 103 |  | 
|---|
| 104 | QObjectList       *queryList( const char *inheritsClass = 0, | 
|---|
| 105 | const char *objName = 0, | 
|---|
| 106 | bool regexpMatch = TRUE, | 
|---|
| 107 | bool recursiveSearch = TRUE ) const; | 
|---|
| 108 |  | 
|---|
| 109 | virtual void insertChild( QObject * ); | 
|---|
| 110 | virtual void removeChild( QObject * ); | 
|---|
| 111 |  | 
|---|
| 112 | void         installEventFilter( const QObject * ); | 
|---|
| 113 | void         removeEventFilter( const QObject * ); | 
|---|
| 114 |  | 
|---|
| 115 | static bool  connect( const QObject *sender, const char *signal, | 
|---|
| 116 | const QObject *receiver, const char *member ); | 
|---|
| 117 | bool         connect( const QObject *sender, const char *signal, | 
|---|
| 118 | const char *member ) const; | 
|---|
| 119 | static bool  disconnect( const QObject *sender, const char *signal, | 
|---|
| 120 | const QObject *receiver, const char *member ); | 
|---|
| 121 | bool         disconnect( const char *signal=0, | 
|---|
| 122 | const QObject *receiver=0, const char *member=0 ); | 
|---|
| 123 | bool         disconnect( const QObject *receiver, const char *member=0 ); | 
|---|
| 124 | static void          connectInternal( const QObject *sender, int signal_index, | 
|---|
| 125 | const QObject *receiver, int membcode, int member_index ); | 
|---|
| 126 | static bool          disconnectInternal( const QObject *sender, int signal_index, | 
|---|
| 127 | const QObject *receiver, int membcode, int member_index ); | 
|---|
| 128 |  | 
|---|
| 129 | void         dumpObjectTree(); | 
|---|
| 130 | void         dumpObjectInfo(); | 
|---|
| 131 |  | 
|---|
| 132 | #ifndef QT_NO_PROPERTIES | 
|---|
| 133 | virtual bool setProperty( const char *name, const QVariant& value ); | 
|---|
| 134 | virtual QVariant property( const char *name ) const; | 
|---|
| 135 | #endif // QT_NO_PROPERTIES | 
|---|
| 136 | #ifdef QT_NO_TRANSLATION | 
|---|
| 137 | static QString tr( const char *sourceText, const char * = 0); | 
|---|
| 138 | #ifndef QT_NO_TEXTCODEC | 
|---|
| 139 | static QString trUtf8( const char *sourceText, const char * = 0); | 
|---|
| 140 | #endif | 
|---|
| 141 | #endif //QT_NO_TRANSLATION | 
|---|
| 142 |  | 
|---|
| 143 | #ifndef QT_NO_USERDATA | 
|---|
| 144 | static uint registerUserData(); | 
|---|
| 145 | void setUserData( uint id, QObjectUserData* data); | 
|---|
| 146 | QObjectUserData* userData( uint id ) const; | 
|---|
| 147 | #endif // QT_NO_USERDATA | 
|---|
| 148 |  | 
|---|
| 149 | signals: | 
|---|
| 150 | void         destroyed(); | 
|---|
| 151 | void         destroyed( QObject* obj ); | 
|---|
| 152 |  | 
|---|
| 153 | public: | 
|---|
| 154 | QObject     *parent() const { return parentObj; } | 
|---|
| 155 |  | 
|---|
| 156 | public slots: | 
|---|
| 157 | void        deleteLater(); | 
|---|
| 158 |  | 
|---|
| 159 | private slots: | 
|---|
| 160 | void         cleanupEventFilter( QObject* ); | 
|---|
| 161 |  | 
|---|
| 162 | protected: | 
|---|
| 163 | bool        activate_filters( QEvent * ); | 
|---|
| 164 | QConnectionList *receivers( const char* signal ) const; | 
|---|
| 165 | QConnectionList *receivers( int signal ) const; | 
|---|
| 166 | void        activate_signal( int signal ); | 
|---|
| 167 | void        activate_signal( int signal, int ); | 
|---|
| 168 | void        activate_signal( int signal, double ); | 
|---|
| 169 | void        activate_signal( int signal, QString ); | 
|---|
| 170 | void        activate_signal_bool( int signal, bool ); | 
|---|
| 171 | void        activate_signal( QConnectionList *clist, QUObject *o ); | 
|---|
| 172 |  | 
|---|
| 173 | const QObject *sender(); | 
|---|
| 174 |  | 
|---|
| 175 | virtual void timerEvent( QTimerEvent * ); | 
|---|
| 176 | virtual void childEvent( QChildEvent * ); | 
|---|
| 177 | virtual void customEvent( QCustomEvent * ); | 
|---|
| 178 |  | 
|---|
| 179 | virtual void connectNotify( const char *signal ); | 
|---|
| 180 | virtual void disconnectNotify( const char *signal ); | 
|---|
| 181 | virtual bool checkConnectArgs( const char *signal, const QObject *receiver, | 
|---|
| 182 | const char *member ); | 
|---|
| 183 | static QCString normalizeSignalSlot( const char *signalSlot ); | 
|---|
| 184 |  | 
|---|
| 185 | private: | 
|---|
| 186 | uint        isSignal   : 1; | 
|---|
| 187 | uint        isWidget   : 1; | 
|---|
| 188 | uint        pendTimer  : 1; | 
|---|
| 189 | uint        blockSig   : 1; | 
|---|
| 190 | uint        wasDeleted : 1; | 
|---|
| 191 | uint        isTree : 1; | 
|---|
| 192 |  | 
|---|
| 193 | const char  *objname; | 
|---|
| 194 | QObject     *parentObj; | 
|---|
| 195 | QObjectList *childObjects; | 
|---|
| 196 | QSignalVec *connections; | 
|---|
| 197 | QSenderObjectList *senderObjects; | 
|---|
| 198 | QObjectList *eventFilters; | 
|---|
| 199 | QPostEventList *postedEvents; | 
|---|
| 200 | QObjectPrivate* d; | 
|---|
| 201 |  | 
|---|
| 202 | static QMetaObject* staticQtMetaObject(); | 
|---|
| 203 |  | 
|---|
| 204 | friend class QApplication; | 
|---|
| 205 | friend class QBaseApplication; | 
|---|
| 206 | friend class QWidget; | 
|---|
| 207 | friend class QSignal; | 
|---|
| 208 |  | 
|---|
| 209 | private:        // Disabled copy constructor and operator= | 
|---|
| 210 | #if defined(Q_DISABLE_COPY) | 
|---|
| 211 | QObject( const QObject & ); | 
|---|
| 212 | QObject &operator=( const QObject & ); | 
|---|
| 213 | #endif | 
|---|
| 214 | }; | 
|---|
| 215 |  | 
|---|
| 216 |  | 
|---|
| 217 | #ifndef QT_NO_USERDATA | 
|---|
| 218 | class Q_EXPORT QObjectUserData { | 
|---|
| 219 | public: | 
|---|
| 220 | virtual ~QObjectUserData(); | 
|---|
| 221 | }; | 
|---|
| 222 | #endif | 
|---|
| 223 |  | 
|---|
| 224 |  | 
|---|
| 225 | inline bool QObject::connect( const QObject *sender, const char *signal, | 
|---|
| 226 | const char *member ) const | 
|---|
| 227 | { | 
|---|
| 228 | return connect( sender, signal, this, member ); | 
|---|
| 229 | } | 
|---|
| 230 |  | 
|---|
| 231 |  | 
|---|
| 232 | inline bool QObject::disconnect( const char *signal, | 
|---|
| 233 | const QObject *receiver, const char *member ) | 
|---|
| 234 | { | 
|---|
| 235 | return disconnect( this, signal, receiver, member ); | 
|---|
| 236 | } | 
|---|
| 237 |  | 
|---|
| 238 |  | 
|---|
| 239 | inline bool QObject::disconnect( const QObject *receiver, const char *member ) | 
|---|
| 240 | { | 
|---|
| 241 | return disconnect( this, 0, receiver, member ); | 
|---|
| 242 | } | 
|---|
| 243 |  | 
|---|
| 244 |  | 
|---|
| 245 | #ifdef QT_NO_TRANSLATION | 
|---|
| 246 | inline QString QObject::tr( const char *sourceText, const char * ) { | 
|---|
| 247 | return QString::fromLatin1( sourceText ); | 
|---|
| 248 | } | 
|---|
| 249 | #ifndef QT_NO_TEXTCODEC | 
|---|
| 250 | inline QString QObject::trUtf8( const char *sourceText, const char * ) { | 
|---|
| 251 | return QString::fromUtf8( sourceText ); | 
|---|
| 252 | } | 
|---|
| 253 | #endif | 
|---|
| 254 | #endif //QT_NO_TRANSLATION | 
|---|
| 255 |  | 
|---|
| 256 |  | 
|---|
| 257 | #define Q_DEFINED_QOBJECT | 
|---|
| 258 | #include "qwinexport.h" | 
|---|
| 259 | #endif // QOBJECT_H | 
|---|