| 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
|
|---|