Home · All Classes · Annotated · Functions

QCopEnvelope Class Reference

The QCopEnvelope class encapsulates and sends QCop messages over QCopChannels. More...

#include <QCopEnvelope>

Inherits QDataStream.

• List of all members, including inherited members

Public Functions

• QCopEnvelope ( const QString & channel, const QString & message )
• ~QCopEnvelope ()

• 45 public functions inherited from QDataStream

Detailed Description

The QCopEnvelope class encapsulates and sends QCop messages over QCopChannels.

QCop messages allow applications to communicate with each other by sending messages using QCopEnvelope and receivng messages by connecting to a QCopChannel.

To send a message, use the following protocol:

    QCopEnvelope e(channelname, messagename);
    e << parameter1 << parameter2 << ...;

For messages without parameters, simply use:

    QCopEnvelope e(channelname, messagename);

where:

• channelname is the channel name within Qtopia, commencing with "QPE/".
• messagename is a function identifier followed by a list of types in parentheses. No whitespace is permitted.

Note: Do not try to simplify this further as it may confuse some compilers.

To receive a message either:

• use the predefined QPE/Application/appname channel in the application. For further information refer to: QtopiaApplication::appMessage().
• create another channel and connect it to a slot using:

       myChannel = new QCopChannel( "QPE/FooBar", this );
       connect( myChannel, SIGNAL(received(const QString&,const QByteArray&)),
                this, SLOT(fooBarMessage(const QString&,const QByteArray&)) );

See also: QCop Messages and Services.

Member Function Documentation

QCopEnvelope::QCopEnvelope ( const QString & channel, const QString & message )

Constructs a QCopEnvelope to write message to channel. If message has parameters then use operator<<() to add the parameters to the envelope.

QCopEnvelope::~QCopEnvelope ()

Writes the message and then destroys the QCopEnvelope.