~ubuntu-branches/ubuntu/quantal/qtmobility/quantal

« back to all changes in this revision

Viewing changes to src/organizer/qorganizeritemchangeset.cpp

  • Committer: Bazaar Package Importer
  • Author(s): Jonathan Riddell
  • Date: 2010-11-16 16:18:07 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20101116161807-k2dzt2nyse975r3l
Tags: 1.1.0-0ubuntu1
* New upstream release
* Syncronise with Debian, no remaining changes

Show diffs side-by-side

added added

removed removed

Lines of Context:
8
8
**
9
9
** $QT_BEGIN_LICENSE:LGPL$
10
10
** Commercial Usage
11
 
** Licensees holding valid Qt Commercial licenses may use this file in
12
 
** accordance with the Qt Solutions Commercial License Agreement provided
13
 
** with the Software or, alternatively, in accordance with the terms
 
11
** Licensees holding valid Qt Commercial licenses may use this file in 
 
12
** accordance with the Qt Commercial License Agreement provided with
 
13
** the Software or, alternatively, in accordance with the terms
14
14
** contained in a written agreement between you and Nokia.
15
15
**
16
16
** GNU Lesser General Public License Usage
33
33
** ensure the GNU General Public License version 3.0 requirements will be
34
34
** met: http://www.gnu.org/copyleft/gpl.html.
35
35
**
36
 
** Please note Third Party Software included with Qt Solutions may impose
37
 
** additional restrictions and it is the user's responsibility to ensure
38
 
** that they have met the licensing requirements of the GPL, LGPL, or Qt
39
 
** Solutions Commercial license and the relevant license of the Third
40
 
** Party Software they are using.
41
 
**
42
36
** If you are unsure which license is appropriate for your use, please
43
37
** contact the sales department at qt-sales@nokia.com.
44
38
** $QT_END_LICENSE$
47
41
 
48
42
#include "qorganizeritemchangeset.h"
49
43
#include "qorganizeritemchangeset_p.h"
50
 
#include "qorganizeritemmanagerengine.h"
 
44
#include "qorganizermanagerengine.h"
51
45
 
52
46
QTM_BEGIN_NAMESPACE
53
47
 
56
50
 
57
51
   \brief The QOrganizerItemChangeSet class provides a simple API to
58
52
   simplify the emission of state-change signals from
59
 
   QOrganizerItemManagerEngine implementations.
 
53
   QOrganizerManagerEngine implementations.
60
54
 
61
55
  \inmodule QtOrganizer
62
56
 
63
57
   This class can be utilised by backend implementations to ensure
64
 
   correct emission of the \l QOrganizerItemManagerEngine::dataChanged(), \l
65
 
   QOrganizerItemManagerEngine::itemsAdded(), \l
66
 
   QOrganizerItemManagerEngine::itemsChanged() and \l
67
 
   QOrganizerItemManagerEngine::itemsRemoved().
 
58
   correct emission of the \l QOrganizerManagerEngine::dataChanged(), \l
 
59
   QOrganizerManagerEngine::itemsAdded(), \l
 
60
   QOrganizerManagerEngine::itemsChanged() and \l
 
61
   QOrganizerManagerEngine::itemsRemoved().
68
62
 
69
 
   \sa QOrganizerItemManagerEngine
 
63
   \sa QOrganizerManagerEngine
70
64
 */
71
65
 
72
66
/*!
103
97
 
104
98
/*!
105
99
   Sets the data changed flag to \a dataChanged.  If this is set to true prior to calling \l emitSignals(),
106
 
   only the \l QOrganizerItemManagerEngine::dataChanged() signal will be emitted; otherwise, the appropriate
 
100
   only the \l QOrganizerManagerEngine::dataChanged() signal will be emitted; otherwise, the appropriate
107
101
   finer-grained signals will be emitted.
108
102
 */
109
103
void QOrganizerItemChangeSet::setDataChanged(bool dataChanged)
123
117
   Returns the set of ids of organizer items which have been added to
124
118
   the database.
125
119
 */
126
 
QSet<QOrganizerItemLocalId> QOrganizerItemChangeSet::addedItems() const
 
120
QSet<QOrganizerItemId> QOrganizerItemChangeSet::addedItems() const
127
121
{
128
122
    return d->m_addedItems;
129
123
}
132
126
  Inserts the given organizer item id \a addedOrganizerItemId into the set of ids of organizer items
133
127
  which have been added to the database.
134
128
 */
135
 
void QOrganizerItemChangeSet::insertAddedItem(QOrganizerItemLocalId addedOrganizerItemId)
 
129
void QOrganizerItemChangeSet::insertAddedItem(const QOrganizerItemId& addedOrganizerItemId)
136
130
{
137
131
    d->m_addedItems.insert(addedOrganizerItemId);
138
132
}
141
135
  Inserts each of the given organizer item ids \a addedOrganizerItemIds into the set of ids of organizer items
142
136
  which have been added to the database.
143
137
 */
144
 
void QOrganizerItemChangeSet::insertAddedItems(const QList<QOrganizerItemLocalId>& addedOrganizerItemIds)
 
138
void QOrganizerItemChangeSet::insertAddedItems(const QList<QOrganizerItemId>& addedOrganizerItemIds)
145
139
{
146
 
    foreach (const QOrganizerItemLocalId& id, addedOrganizerItemIds)
 
140
    foreach (const QOrganizerItemId& id, addedOrganizerItemIds)
147
141
        d->m_addedItems.insert(id);
148
142
}
149
143
 
159
153
   Returns the set of ids of organizer items which have been changed in
160
154
   the database.
161
155
 */
162
 
QSet<QOrganizerItemLocalId> QOrganizerItemChangeSet::changedItems() const
 
156
QSet<QOrganizerItemId> QOrganizerItemChangeSet::changedItems() const
163
157
{
164
158
    return d->m_changedItems;
165
159
}
168
162
  Inserts the given organizer item id \a changedOrganizerItemId into the set of ids of organizer items
169
163
  which have been changed to the database.
170
164
 */
171
 
void QOrganizerItemChangeSet::insertChangedItem(QOrganizerItemLocalId changedOrganizerItemId)
 
165
void QOrganizerItemChangeSet::insertChangedItem(const QOrganizerItemId& changedOrganizerItemId)
172
166
{
173
167
    d->m_changedItems.insert(changedOrganizerItemId);
174
168
}
177
171
  Inserts each of the given organizer item ids \a changedOrganizerItemIds into the set of ids of organizer items
178
172
  which have been changed to the database.
179
173
 */
180
 
void QOrganizerItemChangeSet::insertChangedItems(const QList<QOrganizerItemLocalId>& changedOrganizerItemIds)
 
174
void QOrganizerItemChangeSet::insertChangedItems(const QList<QOrganizerItemId>& changedOrganizerItemIds)
181
175
{
182
 
    foreach (const QOrganizerItemLocalId& id, changedOrganizerItemIds)
 
176
    foreach (const QOrganizerItemId& id, changedOrganizerItemIds)
183
177
        d->m_changedItems.insert(id);
184
178
}
185
179
 
195
189
   Returns the set of ids of organizer items which have been removed from
196
190
   the database.
197
191
 */
198
 
QSet<QOrganizerItemLocalId> QOrganizerItemChangeSet::removedItems() const
 
192
QSet<QOrganizerItemId> QOrganizerItemChangeSet::removedItems() const
199
193
{
200
194
    return d->m_removedItems;
201
195
}
204
198
  Inserts the given organizer item id \a removedOrganizerItemId into the set of ids of organizer items
205
199
  which have been removed to the database.
206
200
 */
207
 
void QOrganizerItemChangeSet::insertRemovedItem(QOrganizerItemLocalId removedOrganizerItemId)
 
201
void QOrganizerItemChangeSet::insertRemovedItem(const QOrganizerItemId& removedOrganizerItemId)
208
202
{
209
203
    d->m_removedItems.insert(removedOrganizerItemId);
210
204
}
213
207
  Inserts each of the given organizer item ids \a removedOrganizerItemIds into the set of ids of organizer items
214
208
  which have been removed to the database.
215
209
 */
216
 
void QOrganizerItemChangeSet::insertRemovedItems(const QList<QOrganizerItemLocalId>& removedOrganizerItemIds)
 
210
void QOrganizerItemChangeSet::insertRemovedItems(const QList<QOrganizerItemId>& removedOrganizerItemIds)
217
211
{
218
 
    foreach (const QOrganizerItemLocalId& id, removedOrganizerItemIds)
 
212
    foreach (const QOrganizerItemId& id, removedOrganizerItemIds)
219
213
        d->m_removedItems.insert(id);
220
214
}
221
215
 
242
236
/*!
243
237
   Emits the appropriate signals from the given \a engine given the state of the change set
244
238
 */
245
 
void QOrganizerItemChangeSet::emitSignals(QOrganizerItemManagerEngine *engine)
 
239
void QOrganizerItemChangeSet::emitSignals(QOrganizerManagerEngine *engine)
246
240
{
247
241
    if (!engine)
248
242
        return;