You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
qt3/src/kernel/qobject.h

290 lines
8.7 KiB

/****************************************************************************
**
** Definition of QObject class
**
** Created : 930418
**
** Copyright (C) 1992-2008 Trolltech ASA. All rights reserved.
**
** This file is part of the kernel module of the Qt GUI Toolkit.
**
** This file may be used under the terms of the GNU General
** Public License versions 2.0 or 3.0 as published by the Free
** Software Foundation and appearing in the files LICENSE.GPL2
** and LICENSE.GPL3 included in the packaging of this file.
** Alternatively you may (at your option) use any later version
** of the GNU General Public License if such license has been
** publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free Qt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file. Licensees holding valid Qt
** Commercial 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 WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef QOBJECT_H
#define QOBJECT_H
#ifndef QT_H
#include "qobjectdefs.h"
#include "qwindowdefs.h"
#include "qstring.h"
#include "qevent.h"
#include "qmutex.h"
#include "qnamespace.h"
#endif // QT_H
#define QT_TR_NOOP(x) (x)
#define QT_TRANSLATE_NOOP(scope,x) (x)
class QMetaObject;
class QVariant;
class QMetaProperty;
class QPostEventList;
class QSenderObjectList;
class QObjectPrivate;
#ifndef QT_NO_USERDATA
class QObjectUserData;
#endif
struct QUObject;
#ifdef QT_THREAD_SUPPORT
class QThread;
#endif
class QStyleControlElementData;
class QStyleControlElementDataPrivate;
class Q_EXPORT QObject: public Qt
{
Q_OBJECT
Q_PROPERTY( QCString name READ name WRITE setName )
public:
QObject( QObject *parent=0, const char *name=0 );
virtual ~QObject();
#ifdef Q_QDOC
virtual const char *className() const;
static QString tr( const char *, const char * );
static QString trUtf8( const char *, const char * );
virtual QMetaObject *metaObject() const;
#endif
virtual bool event( QEvent * );
virtual bool eventFilter( QObject *, QEvent * );
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 *objName, const char *inheritsClass = 0, bool recursiveSearch = TRUE ); //### const in 4.0
const QObjectList *children() const { return childObjects; }
QObjectList childrenListObject();
const QObjectList childrenListObject() const;
static const QObjectList *objectTrees();
static const QObjectList objectTreesListObject();
QObjectList *queryList( const char *inheritsClass = 0,
const char *objName = 0,
bool regexpMatch = TRUE,
bool recursiveSearch = TRUE ) const;
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 );
static void connectInternal( const QObject *sender, int signal_index,
const QObject *receiver, int membcode, int member_index );
static bool disconnectInternal( const QObject *sender, int signal_index,
const QObject *receiver, int membcode, int member_index );
void dumpObjectTree();
void dumpObjectInfo();
QStyleControlElementData* controlElementDataObject();
QStyleControlElementDataPrivate* controlElementDataPrivateObject();
#ifndef QT_NO_PROPERTIES
virtual bool setProperty( const char *name, const QVariant& value );
virtual QVariant property( const char *name ) const;
#endif // QT_NO_PROPERTIES
#ifdef QT_NO_TRANSLATION
static QString tr( const char *sourceText, const char * = 0);
#ifndef QT_NO_TEXTCODEC
static QString trUtf8( const char *sourceText, const char * = 0);
#endif
#endif //QT_NO_TRANSLATION
#ifndef QT_NO_USERDATA
static uint registerUserData();
void setUserData( uint id, QObjectUserData* data);
QObjectUserData* userData( uint id ) const;
#endif // QT_NO_USERDATA
signals:
void destroyed();
void destroyed( QObject* obj );
public:
QObject *parent() const { return parentObj; }
public slots:
void deleteLater();
private slots:
void cleanupEventFilter( QObject* );
protected:
bool activate_filters( QEvent * );
QConnectionList *receivers( const char* signal ) const;
QConnectionList *receivers( int signal ) const;
void activate_signal( int signal );
void activate_signal( int signal, int );
void activate_signal( int signal, double );
void activate_signal( int signal, QString );
void activate_signal_bool( int signal, bool );
void activate_signal( QConnectionList *clist, QUObject *o );
const QObject *sender();
virtual void timerEvent( QTimerEvent * );
virtual void childEvent( QChildEvent * );
virtual void customEvent( QCustomEvent * );
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 );
private:
uint isSignal : 1;
uint isWidget : 1;
uint pendTimer : 1;
uint blockSig : 1;
uint wasDeleted : 1;
uint isTree : 1;
const char *objname;
QObject *parentObj;
QObjectList *childObjects;
QSignalVec *connections;
QSenderObjectList *senderObjects;
QObjectList *eventFilters;
QPostEventList *postedEvents;
QObjectPrivate* d;
static QMetaObject* staticQtMetaObject();
friend class QApplication;
friend class QBaseApplication;
friend class QWidget;
friend class QSignal;
private: // Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
QObject( const QObject & );
QObject &operator=( const QObject & );
#endif
public:
#ifdef QT_THREAD_SUPPORT
QThread* contextThreadObject() const;
void moveToThread(QThread *targetThread);
void disableThreadPostedEvents(bool disable);
#endif
private:
#ifdef QT_THREAD_SUPPORT
void moveToThread_helper(QThread *targetThread);
void setThreadObject_helper(QThread *targetThread);
#endif
};
#ifndef QT_NO_USERDATA
class Q_EXPORT QObjectUserData {
public:
virtual ~QObjectUserData();
};
#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 );
}
#ifdef QT_NO_TRANSLATION
inline QString QObject::tr( const char *sourceText, const char * ) {
return QString::fromLatin1( sourceText );
}
#ifndef QT_NO_TEXTCODEC
inline QString QObject::trUtf8( const char *sourceText, const char * ) {
return QString::fromUtf8( sourceText );
}
#endif
#endif //QT_NO_TRANSLATION
#define Q_DEFINED_QOBJECT
#include "qwinexport.h"
#endif // QOBJECT_H