Qt Toolkit - qobject.h include file

| Classes - Annotated - Tree - Functions - Home - Structure

# qobject.h

This is the verbatim text of the qobject.h include file. It is provided only for illustration; the copyright remains with Trolltech.

    /****************************************************************************
    ** $Id: qt/src/kernel/qobject.h   2.3.0   edited 2001-01-26 $
    **
    ** Definition of QObject class
    **
    ** Created : 930418
    **
    ** Copyright (C) 1992-2000 Trolltech AS.  All rights reserved.
    **
    ** This file is part of the kernel module of the Qt GUI Toolkit.
    **
    ** This file may be distributed under the terms of the Q Public License
    ** as defined by Trolltech AS of Norway and appearing in the file
    ** LICENSE.QPL included in the packaging of this file.
    **
    ** This file may be distributed and/or modified under the terms of the
    ** GNU General Public License version 2 as published by the Free Software
    ** Foundation and appearing in the file LICENSE.GPL included in the
    ** packaging of this file.
    **
    ** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
    ** licenses may use this file in accordance with the Qt Commercial License
    ** Agreement provided with the Software.
    **
    ** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
    ** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
    **
    ** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
    **   information about Qt Commercial License Agreements.
    ** See http://www.trolltech.com/qpl/ for QPL licensing information.
    ** See http://www.trolltech.com/gpl/ for GPL licensing information.
    **
    ** Contact info@trolltech.com if any conditions of this licensing are
    ** not clear to you.
    **
    **********************************************************************/

    #ifndef QOBJECT_H
    #define QOBJECT_H

    #ifndef QT_H
    #include "qobjectdefs.h"
    #include "qwindowdefs.h"
    #include "qstring.h"
    #include "qevent.h"
    #include "qnamespace.h"
    #include "qstringlist.h" // obsolete
    #endif // QT_H

    #define QT_TR_NOOP(x) (x)
    #define QT_TRANSLATE_NOOP(scope,x) (x)

    class QMetaObject;
    class QVariant;

    #ifndef QT_MOC_CPP

    class Q_EXPORT QObject: public Qt
    {
        Q_PROPERTY( QCString name READ name WRITE setName )

    public:
        QObject( QObject *parent=0, const char *name=0 );
        virtual ~QObject();

        static QString tr( const char * );
        static QString tr( const char *, const char * );

        virtual bool event( QEvent * );
        virtual bool eventFilter( QObject *, QEvent * );

        virtual QMetaObject *metaObject() const { return staticMetaObject(); }
        virtual const char  *className()  const;

        bool         isA( const char * )     const;
        bool         inherits( const char * ) const;

        const char  *name() const;
        const char  *name( const char * defaultName ) const;

        virtual void setName( const char *name );
        bool         isWidgetType()   const { return isWidget; }
        bool         highPriority()   const { return FALSE; }

        bool         signalsBlocked()  const { return blockSig; }
        void         blockSignals( bool b );

        int          startTimer( int interval );
        void         killTimer( int id );
        void         killTimers();

        QObject           *child( const char *name, const char *type = 0 );
        const QObjectList *children() const { return childObjects; }

        static const QObjectList *objectTrees();

        //### make queryList const in 3.0
        QObjectList       *queryList( const char *inheritsClass = 0,
                                      const char *objName = 0,
                                      bool regexpMatch = TRUE,
                                      bool recursiveSearch = TRUE );

        virtual void insertChild( QObject * );
        virtual void removeChild( QObject * );

        void         installEventFilter( const QObject * );
        void         removeEventFilter( const QObject * );

        static bool  connect( const QObject *sender, const char *signal,
                              const QObject *receiver, const char *member );
        bool         connect( const QObject *sender, const char *signal,
                              const char *member ) const;
        static bool  disconnect( const QObject *sender, const char *signal,
                                 const QObject *receiver, const char *member );
        bool         disconnect( const char *signal=0,
                                 const QObject *receiver=0, const char *member=0 );
        bool         disconnect( const QObject *receiver, const char *member=0 );

        void         dumpObjectTree();
        void         dumpObjectInfo();

    #ifndef QT_NO_PROPERTIES
        bool setProperty( const char *name, const QVariant& value ); // virtual in Qt 3.0
        QVariant property( const char *name ) const;    // virtual in Qt 3.0
    #endif // QT_NO_PROPERTIES

    signals:
        void         destroyed();

    public:
        QObject     *parent() const { return parentObj; }

    private slots:
        void         cleanupEventFilter();

    protected:
        bool         activate_filters( QEvent * );
        QConnectionList *receivers( const char *signal ) const;
        void         activate_signal( const char *signal );
        void         activate_signal( const char *signal, short );
        void         activate_signal( const char *signal, int );
        void         activate_signal( const char *signal, long );
        void         activate_signal( const char *signal, const char * );
        void         activate_signal_bool( const char *signal, bool );
        void         activate_signal_string( const char *signal, QString );
        void         activate_signal_strref( const char *signal, const QString & );

        const QObject *sender();

        virtual void initMetaObject();
        static QMetaObject* staticMetaObject();

        virtual void timerEvent( QTimerEvent * );
        virtual void childEvent( QChildEvent * );

        virtual void connectNotify( const char *signal );
        virtual void disconnectNotify( const char *signal );
        virtual bool checkConnectArgs( const char *signal, const QObject *receiver,
                                       const char *member );
        static QCString normalizeSignalSlot( const char *signalSlot );

        static  void badSuperclassWarning( const char *className,
                                           const char *superclassName );

    private:
        uint        isSignal   : 1;
        uint        isWidget   : 1;
        uint        pendTimer  : 1;
        uint        pendEvent  : 1;
        uint        blockSig   : 1;
        uint        wasDeleted : 1;
        uint        isTree : 1;

        QMetaObject *queryMetaObject() const;
        static QMetaObject *metaObj;
        const char  *objname;
        QObject     *parentObj;
        QObjectList *childObjects;
        QSignalDict *connections;
        QObjectList *senderObjects;
        QObjectList *eventFilters;
        // ### 3.0 todo: add d pointer

        QObject     *sigSender;

        friend class QApplication;
        friend class QBaseApplication;
        friend class QWidget;
        friend class QSignal;
        friend class QSenderObject;

    private:        // Disabled copy constructor and operator=
    #if defined(Q_DISABLE_COPY)
        QObject( const QObject & );
        QObject &operator=( const QObject & );
    #endif

    public:
        // obsolete
    #ifndef QT_NO_STRINGLIST
        QStringList  superClasses( bool includeThis = FALSE ) const; // obsolete, remove 3.0
    #endif
    };

    #endif

    inline bool QObject::connect( const QObject *sender, const char *signal,
                                  const char *member ) const
    {
        return connect( sender, signal, this, member );
    }

    inline bool QObject::disconnect( const char *signal,
                                     const QObject *receiver, const char *member )
    {
        return disconnect( this, signal, receiver, member );
    }

    inline bool QObject::disconnect( const QObject *receiver, const char *member )
    {
        return disconnect( this, 0, receiver, member );
    }

    inline const QObject *QObject::sender()
    {
        return sigSender;
    }

    class Q_EXPORT QSenderObject : public QObject           // object for sending signals
    {
    public:
        void setSender( QObject *s ) { sigSender=s; }
    };

    #ifdef QT_NO_TRANSLATION
    inline QString QObject::tr( const char *s ) {
        return QString::fromLatin1( s );
    }
    inline QString QObject::tr( const char *s, const char * ) {
        return QString::fromLatin1( s );
    }
    #endif

    #endif // QOBJECT_H