Archived:How to send and receive messages in Qt for Symbian

Article Metadata

---

Tested with

Devices(s): Nokia 5800 XpressMusic

---

Compatibility

Platform(s): S60 3rd Edition, FP1, FP2
S60 5th Edition

---

Article

Keywords: XQMessaging::send (), XQMessage

Created: (27 Jun 2009)

Last edited: fasttrack (14 Sep 2009)

Overview

This code snippets shows how to get send and receive messages in Qt. Mobile Extension APIs contains class XQMessaging and XQMessage which provide a way to send and receive messages.

This snippet requires ReadUserData , NetworkServices, WriteUserData ,UserEnvironment and LocalServices. Self-signing is not possible because a Developer certificate is needed.

Preconditions

• Download the latest Qt for S60 distribution from Qt.
• Install Qt for S60:Installing Qt on S60
• Check this link for installation guide: How to install the package.
• Go through this article: Getting started with Qt for S60
• Go through this article: How to use Mobile Extension APIs

Headers required

 #include "XQMessaging.h"
 #include "XQMessage.h"

.pro file

Add following lines to your .pro file.

symbian:LIBS += -lsendas2 \
    -lmsgs \
    -letext \
    -lefsrv \
    -lcharconv \
    -lgsmu
symbian:TARGET.CAPABILITY = NetworkServices \
    LocalServices \
    ReadUserData \
    WriteUserData \
    UserEnvironment

Send SMS

For sending SMS we need to create message with XQMessage class. After creating message, send it using send() method of XQMessaging class. The following source code demostrate how to send SMS.

Source code

void QtSMSOperation::sendSMS()
{
	XQMessaging messaging;
    XQMessage message(QStringList("98433487876"),QString("Testing"));
 
	if (messaging.send(message) == XQMessaging::NoError)
	{
		QMessageBox msgBox;
		msgBox.setText(tr("SMS was sent successfully"));
		msgBox.exec();
	}
}

Receive SMS

XQMessaging class emitt a signal messageReceived() when SMS is received, with reference of XQMessage class which has message body and sender information. so we need to catch that signal in your slots. The following source code demostrate how to receive SMS.

/* implement signal ans slots to listen all incoming message */
QtSMSOperation::QtSMSOperation(QWidget *parent)
    : QMainWindow(parent)
{
	ui.setupUi(this);
	/* messaging is declared of type XQMessaging in header file.
	* the slot receiveSMS() will get called on al incomming message */
    connect(&messaging, SIGNAL(messageReceived(const XQMessage&)), this, SLOT(receiveSMS(const XQMessage&)));
    messaging.startReceiving(XQMessaging::MsgTypeSMS);
}
 
/* receive incomming message */
void QtSMSOperation::receiveSMS(const XQMessage& message)
{
        /* message.sender() contains the cell number of sender 
         * and message.body contain body part of message */
	QMessageBox::information(0,message.sender(),message.body());
}

Code Example

• The Code Example will show how to send and receive messages in Qt and is tested on Nokia 5800 XpressMusic.