qsignal.3qt

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

.TH QSignal 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
QSignal \- Can be used to send signals without parameters
.SH SYNOPSIS
.br
.PP
\fC#include <qsignal.h>\fR
.PP
.SS "Public Members"
.in +1c
.ti -1c
.BI "\fBQSignal\fR ( QObject * " "parent" "=0, const char * " "name" "=0 )"
.br
.ti -1c
.BI "const char* \fBname\fR () const"
.br
.ti -1c
.BI "virtual void \fBsetName\fR ( const char * name )"
.br
.ti -1c
.BI "bool \fBconnect\fR ( const QObject * " "receiver" ", const char * member )"
.br
.ti -1c
.BI "bool \fBdisconnect\fR ( const QObject * " "receiver" ", const char * " "member" "=0 )"
.br
.ti -1c
.BI "bool \fBisBlocked\fR () const"
.br
.ti -1c
.BI "void \fBblock\fR ( bool b )"
.br
.ti -1c
.BI "void \fBactivate\fR ()"
.br
.in -1c
.SH DESCRIPTION
The QSignal class can be used to send signals without parameters.
.PP
QSignal is a simple extension of QObject that can send plain signals without parameters. If you want to send signals from a class that does not inherit QObject, you can create an internal QSignal object to emit the signal. You must also provide a function that connects the signal to an outside object slot. This is how we have implemented signals in the QMenuData class, which is not a QObject.
.PP
In general, we recommend inheriting QObject instead. QObject provides much more functionality.
.PP
Note that QObject is a \fIprivate\fR base class of QSignal, i.e. you cannot call any QObject member functions from a QSignal object.
.PP
Example:
.PP
.nf
.br
    #include <qsignal.h>
.br
.br
    class MyClass
.br
    {
.br
    public:
.br
        MyClass();
.br
       ~MyClass();
.br
.br
        void doSomething();
.br
.br
        void connect( QObject *receiver, const char *member );
.br
.br
    private:
.br
        QSignal *sig;
.br
    };
.br
.br
    MyClass::MyClass()
.br
    {
.br
        sig = new QSignal;
.br
    }
.br
.br
    MyClass::~MyClass()
.br
    {
.br
        delete sig;
.br
    }
.br
.br
    void MyClass::doSomething()
.br
    {
.br
        // ... does something
.br
        sig->activate();        // activates the signal
.br
    }
.br
.br
    void MyClass::connect( QObject *receiver, const char *member )
.br
    {
.br
        sig->connect( receiver, member );
.br
    }
.fi
.SH MEMBER FUNCTION DOCUMENTATION
.SH "QSignal::QSignal ( QObject * parent=0, const char * name=0 )"
Constructs a signal object with the parent object \fIparent\fR and a \fIname.\fR These arguments are passed directly to QObject.
.SH "void QSignal::activate ()"
Emits the signal.
.PP
See also: isBlock().
.SH "void QSignal::block ( bool b )"
Blocks the signal if \fIb\fR is TRUE, or unblocks the signal if \fIb\fR is FALSE.
.PP
An activated signal disappears into hyperspace if it is blocked.
.PP
See also: isBlocked(), activate() and QObject::blockSignals().
.SH "bool QSignal::connect ( const QObject * receiver, const char * member )"
Connects the signal to \fImember\fR in object \fIreceiver.\fR
.PP
See also: disconnect() and QObject::connect().
.SH "bool QSignal::disconnect ( const QObject * receiver, const char * member=0 )"
Disonnects the signal from \fImember\fR in object \fIreceiver.\fR
.PP
See also: connect() and QObject::disconnect().
.SH "bool QSignal::isBlocked () const"
Returns TRUE if the signal is blocked, or FALSE if it is not blocked.
.PP
The signal is not blocked by default.
.PP
See also: block() and QObject::signalsBlocked().
.SH "const char * QSignal::name () const"
Returns the name of this signal object.
.PP
Since QObject is a private base class, we have added this function, which calls QObject::name().
.SH "void QSignal::setName ( const char * name ) \fC[virtual]\fR"
Sets the name of this signal object to \fIname.\fR
.PP
Since QObject is a private base class, we have added this function, which calls QObject::setName().
.PP
Reimplemented from QObject.
.SH "SEE ALSO"
.BR http://www.troll.no/qt/qsignal.html
.SH COPYRIGHT
Copyright 1992-1999 Troll Tech AS.  See the license file included in
the distribution for a complete license statement.
.SH AUTHOR
Generated automatically from the source code.