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

SMSRequest Class Reference

Access the SMS functionality of the phone. More...

#include <smsrequest.h>

Inherits QObject.

List of all member functions.

Public Members

~SMSRequest ()
enum Disposition { Send, SendAndStore, Store }
QString send ( const SMSMessage & m, Disposition disposition = Send, QString id = QString::null )
void check ()
void firstMessage ()
void nextMessage ()
void deleteMessage ( const QString & id )

Signals

void finished ( const PhoneLine & line, const QString & id, bool success )
void messageCount ( const PhoneLine & line, int total )
void fetched ( const PhoneLine & line, const QString & id, const SMSMessage & m )
void cellBroadcast ( const PhoneLine & line, const CBSMessage & m )

Detailed Description

Access the SMS functionality of the phone.

See also SMSMessage and Qtopia Phone Classes.

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

Member Type Documentation

SMSRequest::Disposition

The disposition of an SMS message that is being transmitted.

SMSRequest::Send - Send the message, but do not store it locally.
SMSRequest::SendAndStore - Send the message, and also store is locally.
SMSRequest::Store - Store the message locally, but do not send it.

Member Function Documentation

SMSRequest::~SMSRequest ()

Destruct an SMSRequest object.

void SMSRequest::cellBroadcast ( const PhoneLine & line, const CBSMessage & m ) `[signal]`

Signal that is emitted when a cell broadcast message is received.

void SMSRequest::check ()

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

void SMSRequest::deleteMessage ( const QString & id )

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

void SMSRequest::fetched ( const PhoneLine & line, const QString & id, const SMSMessage & m ) `[signal]`

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

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

Signal that is emitted when a message has finished being sent.

void SMSRequest::firstMessage ()

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

void SMSRequest::messageCount ( const PhoneLine & line, int total ) `[signal]`

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

void SMSRequest::nextMessage ()

Fetch the next message in the incoming SMS buffer.

Trademarks

Qtopia version 2.2.0