QSMSSender Class Reference
[QtTelephonyModule]

Detailed Description

The QSMSSender class provides facilities to send SMS messages.

Client applications construct an SMS message using QSMSMessage and then call the send() method. Once the message has been delivered, or delivery failed, the finished() signal is emitted.

See also QSMSMessage, QSMSReader, and QCommInterface.

Member Function Documentation

QSMSSender::QSMSSender ( const QString & service = QString(), QObject * parent = 0, QCommInterface::Mode mode = Client )

Construct a new SMS sending object for service and attach it to parent. The object will be created in client mode if mode is Client, or server mode otherwise.

If service is empty, this class will use the first available service that supports SMS sending. If there is more than one service that supports SMS sending, the caller should enumerate them with QCommServiceManager::supports() and create separate QSMSSender objects for each.

See also QCommServiceManager::supports().

QSMSSender::~QSMSSender ()

Destroy this SMS sending object.

void QSMSSender::finished ( const QString & id, QTelephony::Result result )   [signal]

Signal that is emitted when the message associated with id has been sent, or the send failed for some reason. The reason for the failure is specified by result.

See also send().

QString QSMSSender::send ( const QSMSMessage & msg )

Send the SMS message msg and return an identifier for it. This is a convenience method around QSMSSender::send(const QString&, const QSMSMessage&).

See also finished().

void QSMSSender::send ( const QString & id, const QSMSMessage & msg )   [virtual slot]

This is an overloaded member function, provided for convenience.

Send the SMS message msg, and associate the finished() response with the identifier id.

See also finished().