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 QtOrganizer 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 "qorganizeritemobserver.h" |
35 | |
36 | #include <QtCore/qpointer.h> |
37 | |
38 | #include "qorganizermanager.h" |
39 | #include "qorganizermanager_p.h" |
40 | |
41 | QT_BEGIN_NAMESPACE_ORGANIZER |
42 | |
43 | class QOrganizerItemObserverPrivate |
44 | { |
45 | public: |
46 | QOrganizerItemId m_id; |
47 | QPointer<QOrganizerManager> m_manager; |
48 | QOrganizerManagerData *m_managerPrivate; |
49 | }; |
50 | |
51 | /*! |
52 | \class QOrganizerItemObserver |
53 | \brief The QOrganizerItemObserver class is a simple class that emits a signal when a single |
54 | particular item is updated or deleted. |
55 | \inmodule QtOrganizer |
56 | \ingroup organizer-main |
57 | */ |
58 | |
59 | /*! |
60 | Constructs a QOrganizerItemObserver to observe the item in \a manager with the given \a itemId |
61 | and a \a parent object. |
62 | */ |
63 | QOrganizerItemObserver::QOrganizerItemObserver(QOrganizerManager *manager, const QOrganizerItemId &itemId, QObject *parent) |
64 | : QObject(parent), d(new QOrganizerItemObserverPrivate) |
65 | { |
66 | d->m_id = itemId; |
67 | d->m_manager = manager; |
68 | d->m_managerPrivate = QOrganizerManagerData::get(manager); |
69 | d->m_managerPrivate->registerObserver(observer: this); |
70 | } |
71 | |
72 | /*! |
73 | Destroys this observer. |
74 | */ |
75 | QOrganizerItemObserver::~QOrganizerItemObserver() |
76 | { |
77 | if (d->m_manager.data()) |
78 | d->m_managerPrivate->unregisterObserver(observer: this); |
79 | delete d; |
80 | } |
81 | |
82 | /*! |
83 | Returns the ID of the item that this object observes. |
84 | */ |
85 | QOrganizerItemId QOrganizerItemObserver::itemId() const |
86 | { |
87 | return d->m_id; |
88 | } |
89 | |
90 | /*! |
91 | \fn void QOrganizerItemObserver::itemChanged(const QList<QOrganizerItemDetail::DetailType> &typesChanged) |
92 | |
93 | This signal is emitted when the observed item is changed in the manager. |
94 | |
95 | The set of item detail types modified in the reported change is a subset of those listed in \a typesChanged, |
96 | unless \a typesChanged is empty, in which case no limitation on the reported changes may be assumed. |
97 | */ |
98 | |
99 | /*! |
100 | \fn void QOrganizerItemObserver::itemRemoved() |
101 | |
102 | This signal is emitted when the observed item is removed from the manager. |
103 | */ |
104 | |
105 | #include "moc_qorganizeritemobserver.cpp" |
106 | |
107 | QT_END_NAMESPACE_ORGANIZER |
108 | |