1/****************************************************************************
2**
3** Copyright (C) 2015 The Qt Company Ltd.
4** Contact: http://www.qt.io/licensing/
5**
6** This file is part of the QtContacts module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL21$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see http://www.qt.io/terms-conditions. For further
15** information use the contact form at http://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 2.1 or version 3 as published by the Free
20** Software Foundation and appearing in the file LICENSE.LGPLv21 and
21** LICENSE.LGPLv3 included in the packaging of this file. Please review the
22** following information to ensure the GNU Lesser General Public License
23** requirements will be met: https://www.gnu.org/licenses/lgpl.html and
24** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
25**
26** As a special exception, The Qt Company gives you certain additional
27** rights. These rights are described in The Qt Company LGPL Exception
28** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
29**
30** $QT_END_LICENSE$
31**
32****************************************************************************/
33
34#include "qcontactobserver.h"
35
36#include <QtCore/qpointer.h>
37
38#include "qcontactmanager.h"
39#include "qcontactmanager_p.h"
40
41QT_BEGIN_NAMESPACE_CONTACTS
42
43class QContactObserverPrivate
44{
45 public:
46 QContactId m_contactId;
47 QPointer<QContactManager> m_manager;
48};
49
50/*!
51 \class QContactObserver
52 \brief The QContactObserver class is a simple class that emits a signal when a single particular
53 contact is updated or deleted.
54 \inmodule QtContacts
55
56 \ingroup contacts-main
57 */
58
59/*!
60 Constructs a QContactObserver to observe the contact in \a manager with the
61 given \a contactId and \a parent object.
62 */
63QContactObserver::QContactObserver(QContactManager* manager,
64 QContactId contactId,
65 QObject* parent)
66 : QObject(parent),
67 d(new QContactObserverPrivate)
68{
69 d->m_contactId = contactId;
70 d->m_manager = manager;
71 QContactManagerData::registerObserver(m: manager, observer: this);
72}
73
74/*!
75 Destroys this observer.
76 */
77QContactObserver::~QContactObserver()
78{
79 if (!d->m_manager.isNull()) {
80 QContactManagerData::unregisterObserver(m: d->m_manager.data(), observer: this);
81 }
82 delete d;
83}
84
85/*!
86 Returns the contact id of the contact that this object observes.
87 */
88QContactId QContactObserver::contactId() const {
89 return d->m_contactId;
90}
91
92/*!
93 \fn QContactObserver::contactChanged(const QList<QContactDetail::DetailType> &typesChanged)
94
95 This signal is emitted when the observed contact is changed in the manager.
96
97 The set of contact detail types modified in the reported change is a subset of those listed in \a typesChanged,
98 unless \a typesChanged is empty, in which case no limitation on the reported changes may be assumed.
99 */
100
101/*!
102 \fn QContactObserver::contactRemoved()
103
104 This signal is emitted when the observed contact is removed from the manager.
105 */
106
107#include "moc_qcontactobserver.cpp"
108
109QT_END_NAMESPACE_CONTACTS
110

source code of qtpim/src/contacts/qcontactobserver.cpp