Development/Tutorials/Decibel/Handling TextChannels

From KDE TechBase

Abstract

This tutorial will walk you through the process of creating a simple application that uses Decibel's TextChannels to communicate via arbitrary instant messaging networks using telepathy. From the result of this tutorial, only a few more lines of code are needed to produce a functioning text based instant messaging client.

This tutorial is based on the source code of the simpleclient demo included in decibel. An explanation of using the simpleclient demo can be found here.

ChannelHandler class

The first class we will need to create is an implementation of the Decibel::ChannelHandler interface.

The Class Definition

The code below is the class definition for our implementation of the Decibel::ChannelHandler interface.

class MyTextChannelHandler : public Decibel::ChannelHandler {

   Q_OBJECT

public:

   explicit MyTextChannelHandler(QObject * parent = 0);
   ~MyTextChannelHandler();
   bool handleChannel(QtTapioca::Connection *, QtTapioca::Channel *, const bool);

public slots:

   void onMessageReceived();
   void onCloseChannel();

private:

   QtTapioca::Connection *  m_connection;
   QtTapioca::TextChannel * m_channel;

};