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.
