00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00018
00019
00020
00021
00022 #ifndef _TelepathyQt4_cli_contact_h_HEADER_GUARD_
00023 #define _TelepathyQt4_cli_contact_h_HEADER_GUARD_
00024
00025 #ifndef IN_TELEPATHY_QT4_HEADER
00026 #error IN_TELEPATHY_QT4_HEADER
00027 #endif
00028
00029 #include <QObject>
00030 #include <QSet>
00031 #include <QSharedPointer>
00032 #include <QVariantMap>
00033
00034 #include <TelepathyQt4/Types>
00035
00036 namespace Telepathy
00037 {
00038 namespace Client
00039 {
00040
00041 class ContactManager;
00042 class PendingOperation;
00043 class ReferencedHandles;
00044
00045 class Contact : public QObject
00046 {
00047 Q_OBJECT
00048
00049 public:
00050 enum Feature {
00051 FeatureAlias,
00052 FeatureAvatarToken,
00053 FeatureSimplePresence,
00054 _Padding = 0xFFFFFFFF
00055 };
00056
00057 enum PresenceState {
00058 PresenceStateNo,
00059 PresenceStateAsk,
00060 PresenceStateYes
00061 };
00062
00063 ContactManager *manager() const;
00064
00065 ReferencedHandles handle() const;
00066 QString id() const;
00067
00068 QSet<Feature> requestedFeatures() const;
00069 QSet<Feature> actualFeatures() const;
00070
00071 QString alias() const;
00072
00073 bool isAvatarTokenKnown() const;
00074 QString avatarToken() const;
00075
00076 QString presenceStatus() const;
00077 uint presenceType() const;
00078 QString presenceMessage() const;
00079
00080 PresenceState subscriptionState() const;
00081 PresenceState publishState() const;
00082
00083 PendingOperation *requestPresenceSubscription(const QString &message = QString());
00084 PendingOperation *removePresenceSubscription(const QString &message = QString());
00085 PendingOperation *authorizePresencePublication(const QString &message = QString());
00086 PendingOperation *removePresencePublication(const QString &message = QString());
00087
00088 bool isBlocked() const;
00089 PendingOperation *block(bool value = true);
00090
00091 ~Contact();
00092
00093 Q_SIGNALS:
00094 void aliasChanged(const QString &alias);
00095 void avatarTokenChanged(const QString &avatarToken);
00096 void simplePresenceChanged(const QString &status, uint type, const QString &presenceMessage);
00097
00098 void subscriptionStateChanged(Telepathy::Client::Contact::PresenceState state);
00099 void publishStateChanged(Telepathy::Client::Contact::PresenceState state);
00100 void blockStatusChanged(bool blocked);
00101
00102
00103
00104
00105
00106
00107
00108 private:
00109 Q_DISABLE_COPY(Contact);
00110
00111 Contact(ContactManager *manager, const ReferencedHandles &handle,
00112 const QSet<Feature> &requestedFeatures, const QVariantMap &attributes);
00113
00114 void augment(const QSet<Feature> &requestedFeatures, const QVariantMap &attributes);
00115
00116 void receiveAlias(const QString &alias);
00117 void receiveAvatarToken(const QString &avatarToken);
00118 void receiveSimplePresence(const SimplePresence &presence);
00119
00120 void setSubscriptionState(PresenceState state);
00121 void setPublishState(PresenceState state);
00122 void setBlocked(bool value);
00123
00124 struct Private;
00125 friend class ContactManager;
00126 friend struct Private;
00127 Private *mPriv;
00128 };
00129
00130 typedef QSet<QSharedPointer<Contact> > Contacts;
00131
00132 inline uint qHash(const QSharedPointer<Contact> &contact)
00133 {
00134 return qHash(contact.data());
00135 }
00136
00137 }
00138 }
00139
00140 #endif