blob: 1e4e164eb1013e6dab5fd3a8e35be0a9c73f2f15 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
// SPDX-FileCopyrightText: 2009 Manjeet Dahiya <manjeetdahiya@gmail.com>
//
// SPDX-License-Identifier: LGPL-2.1-or-later
#ifndef QXMPPVCARDMANAGER_H
#define QXMPPVCARDMANAGER_H
#include "QXmppClientExtension.h"
class QXmppVCardIq;
class QXmppVCardManagerPrivate;
///
/// \brief The QXmppVCardManager class gets/sets XMPP vCards. It is an
/// implementation of \xep{0054}: vcard-temp.
///
/// \note Its object should not be created using its constructor. Instead
/// \c QXmppClient::findExtension<QXmppVCardManager>() should be used to get
/// the instantiated object of this class.
///
/// <B>Getting vCards of entries in Roster:</B><BR>
/// It doesn't store vCards of the JIDs in the roster of connected user. Instead
/// client has to request for a particular vCard using requestVCard(). And connect to
/// the signal vCardReceived() to get the requested vCard.
///
/// <B>Getting vCard of the connected client:</B><BR>
/// For getting the vCard of the connected user itself. Client can call requestClientVCard()
/// and on the signal clientVCardReceived() it can get its vCard using clientVCard().
///
/// <B>Setting vCard of the client:</B><BR>
/// Using setClientVCard() client can set its vCard.
///
/// \note Client can't set/change vCards of roster entries.
///
/// \ingroup Managers
///
class QXMPP_EXPORT QXmppVCardManager : public QXmppClientExtension
{
Q_OBJECT
public:
QXmppVCardManager();
~QXmppVCardManager() override;
QString requestVCard(const QString &bareJid = QString());
const QXmppVCardIq &clientVCard() const;
void setClientVCard(const QXmppVCardIq &);
QString requestClientVCard();
bool isClientVCardReceived() const;
/// \cond
QStringList discoveryFeatures() const override;
bool handleStanza(const QDomElement &element) override;
/// \endcond
Q_SIGNALS:
/// This signal is emitted when the requested vCard is received
/// after calling the requestVCard() function.
void vCardReceived(const QXmppVCardIq &);
/// This signal is emitted when the client's vCard is received
/// after calling the requestClientVCard() function.
void clientVCardReceived();
private:
const std::unique_ptr<QXmppVCardManagerPrivate> d;
};
#endif // QXMPPVCARDMANAGER_H
|
