Home · All Classes · Grouped Classes · Annotated · Functions

MmsComms Class Reference

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

    #include <MmsComms>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• MmsComms ( QMailAccount * acc, QObject * parent = 0 )
• virtual ~MmsComms ()
• virtual void clearRequests () = 0
• virtual bool isActive () const = 0
• QString networkConfig () const
• virtual void retrieveMessage ( const QUrl & url ) = 0
• virtual void sendMessage ( MMSMessage & msg, const QByteArray & encoded ) = 0

• 29 public functions inherited from QObject

Signals

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

• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The MmsComms class is the base class for MMS communications.

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 ( QMailAccount * acc, QObject * parent = 0 )

Constructs a MmsComms, associated with account acc and having parent object parent.

MmsComms::~MmsComms ()   [virtual]

Destroys this MmsComms.

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.

QString MmsComms::networkConfig () const

Returns the default WAP networking account.

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 QMailAccount 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, const QByteArray & encoded )   [pure virtual]

Connect to the MMSC and POST the specified MMS message msg, the encoded content of which is contained in encoded. If a connection to a WAP gateway is necessary, it should be done also. The QMailAccount 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 size )   [signal]

This signal must be emitted during data transfers so that the user can see how much data has been transferred. size denotes the amount of data transferred in bytes.

void MmsComms::transfersComplete ()   [signal]

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