qobject.3qt

tmark1.11:用于生成QT/EMBEDDED应用工程的Markfile文件

.TH QObject 3qt "6 July 1999" "Troll Tech AS" \" -*- nroff -*-
.\" Copyright 1992-1999 Troll Tech AS.  All rights reserved.  See the
.\" license file included in the distribution for a complete license
.\" statement.
.\"
.ad l
.nh
.SH NAME
QObject \- The base class of all Qt objects that can deal with signals, slots and events
.SH SYNOPSIS
.br
.PP
\fC#include <qobject.h>\fR
.PP
Inherits Qt.
.PP
Inherited by QAccel, QApplication, QClipboard, QDataPump, QDragManager, QDragObject, QFileIconProvider, QLayout, QNPInstance, QSenderObject, QServerSocket, QSessionManager, QSignal, QSignalMapper, QSocket, QSocketNotifier, QStyle, QStyleSheet, QTimer, QToolTipGroup, QTranslator, QValidator and QWidget.
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQObject\fR ( QObject * " "parent" "=0, const char * " "name" "=0 )"
.br
.ti -1c
.BI "virtual \fB~QObject\fR ()"
.br
.ti -1c
.BI "virtual bool \fBevent\fR ( QEvent * )"
.br
.ti -1c
.BI "virtual bool \fBeventFilter\fR ( QObject *, QEvent * )"
.br
.ti -1c
.BI "virtual QMetaObject* \fBmetaObject\fR () const"
.br
.ti -1c
.BI "virtual const char* \fBclassName\fR () const"
.br
.ti -1c
.BI "bool \fBisA\fR ( const char * ) const"
.br
.ti -1c
.BI "bool \fBinherits\fR ( const char * ) const"
.br
.ti -1c
.BI "QStringList \fBsuperClasses\fR ( bool " "includeThis" " = FALSE ) const"
.br
.ti -1c
.BI "const char* \fBname\fR () const"
.br
.ti -1c
.BI "const char* \fBname\fR ( const char * defaultName ) const"
.br
.ti -1c
.BI "virtual void \fBsetName\fR ( const char * name )"
.br
.ti -1c
.BI "bool \fBisWidgetType\fR () const"
.br
.ti -1c
.BI "bool \fBhighPriority\fR () const"
.br
.ti -1c
.BI "bool \fBsignalsBlocked\fR () const"
.br
.ti -1c
.BI "void \fBblockSignals\fR ( bool b )"
.br
.ti -1c
.BI "int \fBstartTimer\fR ( int interval )"
.br
.ti -1c
.BI "void \fBkillTimer\fR ( int id )"
.br
.ti -1c
.BI "void \fBkillTimers\fR ()"
.br
.ti -1c
.BI "QObject* \fBchild\fR ( const char * " "name" ", const char * " "type" " = 0 )"
.br
.ti -1c
.BI "const QObjectList* \fBchildren\fR () const"
.br
.ti -1c
.BI "QObjectList* \fBqueryList\fR ( const char * " "inheritsClass" " = 0, const char * " "objName" " = 0, bool " "regexpMatch" " = TRUE, bool " "recursiveSearch" " = TRUE )"
.br
.ti -1c
.BI "virtual void \fBinsertChild\fR ( QObject * )"
.br
.ti -1c
.BI "virtual void \fBremoveChild\fR ( QObject * )"
.br
.ti -1c
.BI "void \fBinstallEventFilter\fR ( const QObject * )"
.br
.ti -1c
.BI "void \fBremoveEventFilter\fR ( const QObject * )"
.br
.ti -1c
.BI "bool \fBconnect\fR ( const QObject * " "sender" ", const char * " "signal" ", const char * member ) const"
.br
.ti -1c
.BI "bool \fBdisconnect\fR ( const char * " "signal" "=0, const QObject * " "receiver" "=0, const char * " "member" "=0 )"
.br
.ti -1c
.BI "bool \fBdisconnect\fR ( const QObject * " "receiver" ", const char * " "member" "=0 )"
.br
.ti -1c
.BI "void \fBdumpObjectTree\fR ()"
.br
.ti -1c
.BI "void \fBdumpObjectInfo\fR ()"
.br
.ti -1c
.BI "QObject* \fBparent\fR () const"
.br
.in -1c
.SS "Signals"
.in +1c
.ti -1c
.BI "void \fBdestroyed\fR ()"
.br
.in -1c
.SS "Static Public Members"
.in +1c
.ti -1c
.BI "QString \fBtr\fR ( const char * )"
.br
.ti -1c
.BI "bool \fBconnect\fR ( const QObject * " "sender" ", const char * " "signal" ", const QObject * " "receiver" ", const char * member )"
.br
.ti -1c
.BI "bool \fBdisconnect\fR ( const QObject * " "sender" ", const char * " "signal" ", const QObject * " "receiver" ", const char * member )"
.br
.in -1c
.SS "Protected Members"
.in +1c
.ti -1c
.BI "bool \fBactivate_filters\fR ( QEvent * )"
.br
.ti -1c
.BI "QConnectionList* \fBreceivers\fR ( const char * signal ) const"
.br
.ti -1c
.BI "void \fBactivate_signal\fR ( const char * signal )"
.br
.ti -1c
.BI "void \fBactivate_signal\fR ( const char * " "signal" ", short )"
.br
.ti -1c
.BI "void \fBactivate_signal\fR ( const char * " "signal" ", int )"
.br
.ti -1c
.BI "void \fBactivate_signal\fR ( const char * " "signal" ", long )"
.br
.ti -1c
.BI "void \fBactivate_signal\fR ( const char * " "signal" ", const char * )"
.br
.ti -1c
.BI "void \fBactivate_signal_bool\fR ( const char * " "signal" ", bool )"
.br
.ti -1c
.BI "void \fBactivate_signal_string\fR ( const char * " "signal" ", QString )"
.br
.ti -1c
.BI "void \fBactivate_signal_strref\fR ( const char * " "signal" ", const QString & )"
.br
.ti -1c
.BI "const QObject* \fBsender\fR ()"
.br
.ti -1c
.BI "virtual void \fBinitMetaObject\fR ()"
.br
.ti -1c
.BI "virtual void \fBtimerEvent\fR ( QTimerEvent * )"
.br
.ti -1c
.BI "virtual void \fBchildEvent\fR ( QChildEvent * )"
.br
.ti -1c
.BI "virtual void \fBconnectNotify\fR ( const char * signal )"
.br
.ti -1c
.BI "virtual void \fBdisconnectNotify\fR ( const char * signal )"
.br
.ti -1c
.BI "virtual bool \fBcheckConnectArgs\fR ( const char * " "signal" ", const QObject * " "receiver" ", const char * member )"
.br
.in -1c
.SS "Static Protected Members"
.in +1c
.ti -1c
.BI "void \fBstaticMetaObject\fR ()"
.br
.ti -1c
.BI "void \fBbadSuperclassWarning\fR ( const char * " "className" ", const char * superclassName )"
.br
.in -1c
.SH RELATED FUNCTION DOCUMENTATION
(Note that these are not member functions.)
.in +1c
.ti -1c
.BI "void * \fBqt_find_obj_child\fR (QObject * " "parent" ", const char * " "type" ", const char * " "name" ")"
.br
.in -1c
.SH DESCRIPTION
The QObject class is the base class of all Qt objects that can deal with signals, slots and events.
.PP
Qt provides a very powerful mechanism for seamless object communication; signal/slot connections. The signal/slot mechanism is an advanced way of making traditional callback routines.
.PP
Example:
.PP
.nf
.br
    //
.br
    // The Mandelbrot class uses a QTimer to calculate the mandelbrot
.br
    // set one scanline at a time without blocking the CPU.
.br
    // It inherits QObject to use signals and slots.
.br
    // Calling start() starts the calculation. The done() signal is
.br
    // emitted when it has finished.
.br
    // Note that this example is not complete. Feel free to complete it.
.br
    //
.br
.br
    class Mandelbrot : public QObject
.br
    {
.br
        Q_OBJECT                                // required for signals/slots
.br
    public:
.br
        Mandelbrot( QObject *parent=0, const char *name );
.br
        ...
.br
    public slots:
.br
        void    start();
.br
    signals:
.br
        void    done();
.br
    private slots:
.br
        void    calculate();
.br
    private:
.br
        QTimer  timer;
.br
        ...
.br
    };
.br
.br
    //
.br
    // Constructs and initializes a Mandelbrot object.
.br
    //
.br
.br
    Mandelbrot::Mandelbrot( QObject *parent=0, const char *name )
.br
        : QObject( parent, name )
.br
    {
.br
        connect( &timer, SIGNAL(timeout()), SLOT(calculate()) );
.br
        ...
.br
    }
.br
.br
    //
.br
    // Starts the calculation task. The internal calculate() slot
.br
    // will be activated every 10 milliseconds.
.br
    //
.br
.br
    void Mandelbrot::start()
.br
    {
.br
        if ( !timer.isActive() )                // not already running
.br
            timer.start( 10 );                  // timeout every 10 ms
.br
    }
.br
.br
    //
.br
    // Calculates one scanline at a time.
.br
    // Emits the done() signal when finished.
.br
    //
.br
.br
    void Mandelbrot::calculate()
.br
    {
.br
        ...                     // perform the calculation for a scanline
.br
        if ( finished ) {       // no more scanlines
.br
           timer.stop();