kopete/protocols/telepathy/telepathycontact.h

   1 /*
   2  * telepathycontact.h - Telepathy Kopete Contact.
   3  *
   4  * Copyright (c) 2006 by Michaël Larouche <larouche@kde.org>
   5  *
   6  * Kopete    (c) 2002-2006 by the Kopete developers  <kopete-devel@kde.org>
   7  *
   8  *************************************************************************
   9  *                                                                       *
  10  * This program is free software; you can redistribute it and/or modify  *
  11  * it under the terms of the GNU General Public License as published by  *
  12  * the Free Software Foundation; either version 2 of the License, or     *
  13  * (at your option) any later version.                                   *
  14  *                                                                       *
  15  *************************************************************************
  16  */
  17 #ifndef TELEPATHYCONTACT_H
  18 #define TELEPATHYCONTACT_H
  19
  20 // Qt Includes
  21 #include <QtCore/QMap>
  22 #include <QtCore/QList>
  23
  24 // Kopete includes
  25 #include <kopetecontact.h>
  26
  27 // QtTapioca includes
  28 #include <QtTapioca/ContactBase>
  29
  30 class KAction;
  31
  32 namespace QtTapioca
  33 {
  34         class Contact;
  35         class Avatar;
  36 }
  37
  38 namespace Kopete
  39 {
  40         class ChatSession;
  41         class MetaContact;
  42 }
  43 class TelepathyAccount;
  44
  45 class TelepathyContact : public Kopete::Contact
  46 {
  47         Q_OBJECT
  48 public:
  49         TelepathyContact(TelepathyAccount *account, const QString &contactId, Kopete::MetaContact *parent);
  50         ~TelepathyContact();
  51
  52         virtual bool isReachable();
  53         virtual void serialize(QMap< QString, QString >& serializedData, QMap< QString, QString >& addressBookData);
  54
  55         virtual QList<KAction *> *customContextMenuActions();
  56         virtual Kopete::ChatSession *manager( CanCreateFlags canCreate = CannotCreate );
  57
  58         void setInternalContact(QtTapioca::Contact *internalContact);
  59
  60         /**
  61          * @brief Reimplement Kopete::Contact::account() to cast to specific TelepathyAccount
  62          * @return TelepathyAccount for this contact.
  63          */
  64         TelepathyAccount *account();
  65
  66         /**
  67          * @brief Get the internal Tapioca contact.
  68          * @return the internal Tapioca contact instance (a reference)
  69          */
  70         QtTapioca::Contact *internalContact();
  71
  72 public slots:
  73         /**
  74          * @brief Delete the contact on server and remove it from Kopete.
  75          */
  76         virtual void deleteContact();
  77
  78 private slots:
  79         /**
  80          * @brief Called when the contact has updated its presence information.
  81          * @param contactBase Referring ContactBase
  82          * @param presence New presence.
  83          * @param presenceMessage New presenceMessage, if any.
  84          */
  85         void telepathyPresenceUpdated(QtTapioca::ContactBase *contactBase, QtTapioca::ContactBase::Presence presence, const QString &presenceMessage);
  86
  87         /**
  88          * @brief Called when contact has changed its alias.
  89          * @param contactBase Referring ContactBase
  90          * @param alias New alias
  91          */
  92         void telepathyAliasChanged(QtTapioca::ContactBase *contactBase, const QString &alias);
  93
  94         /**
  95          * @brief Called when contact has changed its avatar.
  96          * @param contact Referring ContactBase
  97          * @param newToken New token for the avatar update
  98          */
  99         void telepathyAvatarChanged(QtTapioca::ContactBase *contact, const QString &newToken);
 100
 101         /**
 102          * @brief Called when we got avatar from contact.
 103          * @param contact Referring ContactBase
 104          * @param avatar New avatar data
 105          */
 106         void telepathyAvatarReceived(QtTapioca::ContactBase *contact, QtTapioca::Avatar *avatar);
 107
 108         void actionAuthorize();
 109         void actionSubscribe();
 110
 111 private:
 112         class Private;
 113         Private *d;
 114 };
 115 #endif