Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QtopiaIpcEnvelope Class Reference
[QtBaseModule]

The QtopiaIpcEnvelope class encapsulates and sends QCop messages. More...

    #include <QtopiaIpcEnvelope>

Inherits QDataStream.

• List of all members, including inherited members

Public Functions

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

• 39 public functions inherited from QDataStream

Detailed Description

The QtopiaIpcEnvelope class encapsulates and sends QCop messages.

QCop messages allow applications to communicate with each other by sending messages using QtopiaIpcEnvelope and receiving messages by connecting to a QtopiaChannel.

To send a message, use the following protocol:

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

For messages without parameters, simply use:

    QtopiaIpcEnvelope 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 white space 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 QtopiaChannel( "QPE/FooBar", this );
       connect( myChannel, SIGNAL(received(QString,QByteArray)),
                this, SLOT(fooBarMessage(QString,QByteArray)) );

See also: Qt Extended IPC and Services.

Consider using QtopiaIpcAdaptor or QtopiaServiceRequest instead of QtopiaIpcEnvelope, as they provide a better interface for sending QCop messages.

See also QtopiaChannel, QtopiaIpcAdaptor, and QtopiaServiceRequest.

Member Function Documentation

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

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

QtopiaIpcEnvelope::~QtopiaIpcEnvelope ()

Writes the message and then destroys the QtopiaIpcEnvelope.