Qtopia Home - Classes - Hierachy - Annotated - Functions - Licenses - Reference

MmsComms Class Reference

The MmsComms class is the base class for MMS communications. More...

#include <mmscomms.h>

Inherits QObject.

List of all member functions.

Public Members

• MmsComms ( MailAccount * acc, QObject * parent = 0, const char * name = 0 )
• ~MmsComms ()
• virtual void sendMessage ( MMSMessage & msg ) = 0
• virtual void retrieveMessage ( const QUrl & url ) = 0
• virtual bool isActive () const = 0
• virtual void clearRequests () = 0

Signals

• void notificationInd ( const MMSMessage & msg )
• void deliveryInd ( const MMSMessage & msg )
• void sendConf ( const MMSMessage & msg )
• void retrieveConf ( const MMSMessage & msg, int size )
• void statusChange ( const QString & status )
• void error ( int code, const QString & msg )
• void transferSize ( int )
• void transfersComplete ()

Detailed Description

The MmsComms class is the base class for MMS communications. Usually MMS communications via WAP is implemented by deriving from this class and implementing the pure virtual functions and emitting the signals when appropriate.

Member Function Documentation

MmsComms::MmsComms ( MailAccount * acc, QObject * parent = 0, const char * name = 0 )

void MmsComms::clearRequests () [pure virtual]

Clear any requests that are pending or in progress.

void MmsComms::deliveryInd ( const MMSMessage & msg ) [signal]

This signal must be emitted when an m-delivery-ind MMS message msg arrives via WAP PUSH.

void MmsComms::error ( int code, const QString & msg ) [signal]

This signal must be emitted when a fatal error occurs during the communication process, e.g. connection refused. The code code should reflect the error seen by the underlying network protocol being used. The error message msg must be a suitable for displaying to the user and refect the meaning of code.

bool MmsComms::isActive () const [pure virtual]

Return TRUE if there are requests pending or in progress, otherwise FALSE.

void MmsComms::notificationInd ( const MMSMessage & msg ) [signal]

This signal must be emitted when an m-notification-ind MMS message msg arrives via WAP PUSH.

void MmsComms::retrieveConf ( const MMSMessage & msg, int size ) [signal]

This signal must be emitted in response to a retrieveMessage(), unless an error occurrs. The MMS message msg contains the message as decoded by retrieveMessage() which has a encoded size of size.

See also error().

void MmsComms::retrieveMessage ( const QUrl & url ) [pure virtual]

Connect to the MMSC and GET an MMS message from URL url. If a connection to a WAP gateway is necessary, it should be done also. The MailAccount details can be accessed via the account variable.

See also retrieveConf().

void MmsComms::sendConf ( const MMSMessage & msg ) [signal]

This signal must be emitted in response to a sendMessage(), unless an error occurs. The MMS message msg contains the confirmation details and the message content as received by sendMessage() .

See also error().

void MmsComms::sendMessage ( MMSMessage & msg ) [pure virtual]

Connect to the MMSC and POST the specified MMS message msg. If a connection to a WAP gateway is necessary, it should be done also. The MailAccount details can be accessed via the account variable.

See also sendConf().

void MmsComms::statusChange ( const QString & status ) [signal]

This signal can be emitted when the status of a transfer changes, e.g. connected to server, transferring data. The status status could be used to provide user feed back eg: a status bar.

See also error().

void MmsComms::transferSize ( int ) [signal]

This signal must be emitted during data transfers so that the user can see how much data has been transferred.

void MmsComms::transfersComplete () [signal]

This signal must be emitted when all pending or current transfers have completed.

This file is part of the Qtopia platform, copyright © 1995-2005 Trolltech, all rights reserved.