Home · All Classes · Annotated · Functions

QSMSRequest Class Reference

The QSMSRequest class accesses the SMS functionality of the phone. More...

#include <QSMSRequest>

Inherits QObject.

List of all members, including inherited members

Public Types

enum Disposition { Send, SendAndStore, Store }

Public Functions

~QSMSRequest ()
void check ()
void deleteMessage ( const QString & id )
void firstMessage ()
void nextMessage ()
QString send ( const QSMSMessage & m, QSMSRequest::Disposition disposition = Send, QString id = QString() )

36 public functions inherited from QObject

Signals

void cellBroadcast ( const QPhoneLine & line, const QCBSMessage & m )
void fetched ( const QPhoneLine & line, const QString & id, const QSMSMessage & m )
void finished ( const QPhoneLine & line, const QString & id, bool success )
void messageCount ( const QPhoneLine & line, int total )

1 signal inherited from QObject

Additional Inherited Members

1 property inherited from QObject
1 public slot inherited from QObject
4 static public members inherited from QObject
8 protected functions inherited from QObject
2 protected variables inherited from QObject
1 static protected member inherited from QObject

Detailed Description

The QSMSRequest class accesses the SMS functionality of the phone.

The QSMSRequest class provides access to SMS functionality on the phone device, to send and receive SMS and cell broadcast messages.

Member Type Documentation

enum QSMSRequest::Disposition

The disposition of an SMS message that is being transmitted.

Constant	Value	Description
`QSMSRequest::Send`	`0`	Send the message, but do not store it locally.
`QSMSRequest::SendAndStore`	`1`	Send the message, and also store is locally.
`QSMSRequest::Store`	`2`	Store the message locally, but do not send it.

Member Function Documentation

QSMSRequest::~QSMSRequest ()

Destruct an QSMSRequest object.

void QSMSRequest::cellBroadcast ( const QPhoneLine & line, const QCBSMessage & m ) `[signal]`

Signal that is emitted when a cell broadcast message m is received on line.

void QSMSRequest::check ()

Fetch the total number of messages in the incoming SMS buffer. The number is returned via the QSMSRequest::messageCount signal.

void QSMSRequest::deleteMessage ( const QString & id )

Delete the message with the identifier id from the incoming SMS buffer.

void QSMSRequest::fetched ( const QPhoneLine & line, const QString & id, const QSMSMessage & m ) `[signal]`

Signal that is emitted when a message in the incoming SMS buffer of line is fetched. id will be zero-length if there are no remaining messages in the buffer to be fetched. Otherwise, the message content is in m.

void QSMSRequest::finished ( const QPhoneLine & line, const QString & id, bool success ) `[signal]`

Signal that is emitted when a message has finished being sent on line. The message's identifier is id, and success indicates whether the transmission was successful or not.

void QSMSRequest::firstMessage ()

Fetch the first message in the incoming SMS buffer. Note: only one application (usually qtmail) should ever call this method and QSMSRequest::nextMessage.

void QSMSRequest::messageCount ( const QPhoneLine & line, int total ) `[signal]`

Signal that is emitted when either a new message arrives on line, the total count is explicitly fetched using QSMSRequest::check, or a message is deleted using QSMSRequest::deleteMessage.

void QSMSRequest::nextMessage ()

Fetch the next message in the incoming SMS buffer.

QString QSMSRequest::send ( const QSMSMessage & m, QSMSRequest::Disposition disposition = Send, QString id = QString() )

Send the SMS message m with the specified disposition. The identifier id is associated with the message, which allows the caller to track its progress via the QSMSRequest::finished signal.

Trademarks

Qtopia 4.1.7