author | Eckhart Koeppen <eckhart.koppen@nokia.com> |
Wed, 21 Apr 2010 11:15:19 +0300 | |
branch | RCL_3 |
changeset 11 | 25a739ee40f4 |
parent 7 | 3f74d0d4af4c |
permissions | -rw-r--r-- |
0 | 1 |
/**************************************************************************** |
2 |
** |
|
4
3b1da2848fc7
Revision: 201003
Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
parents:
0
diff
changeset
|
3 |
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). |
0 | 4 |
** All rights reserved. |
5 |
** Contact: Nokia Corporation (qt-info@nokia.com) |
|
6 |
** |
|
7 |
** This file is part of the QtGui module of the Qt Toolkit. |
|
8 |
** |
|
9 |
** $QT_BEGIN_LICENSE:LGPL$ |
|
10 |
** No Commercial Usage |
|
11 |
** This file contains pre-release code and may not be distributed. |
|
12 |
** You may use this file in accordance with the terms and conditions |
|
13 |
** contained in the Technology Preview License Agreement accompanying |
|
14 |
** this package. |
|
15 |
** |
|
16 |
** GNU Lesser General Public License Usage |
|
17 |
** Alternatively, this file may be used under the terms of the GNU Lesser |
|
18 |
** General Public License version 2.1 as published by the Free Software |
|
19 |
** Foundation and appearing in the file LICENSE.LGPL included in the |
|
20 |
** packaging of this file. Please review the following information to |
|
21 |
** ensure the GNU Lesser General Public License version 2.1 requirements |
|
22 |
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. |
|
23 |
** |
|
24 |
** In addition, as a special exception, Nokia gives you certain additional |
|
25 |
** rights. These rights are described in the Nokia Qt LGPL Exception |
|
26 |
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. |
|
27 |
** |
|
28 |
** If you have questions regarding the use of this file, please contact |
|
29 |
** Nokia at qt-info@nokia.com. |
|
30 |
** |
|
31 |
** |
|
32 |
** |
|
33 |
** |
|
34 |
** |
|
35 |
** |
|
36 |
** |
|
37 |
** |
|
38 |
** $QT_END_LICENSE$ |
|
39 |
** |
|
40 |
****************************************************************************/ |
|
41 |
||
42 |
#include "qabstractproxymodel.h" |
|
43 |
||
44 |
#ifndef QT_NO_PROXYMODEL |
|
45 |
||
46 |
#include "qitemselectionmodel.h" |
|
47 |
#include <private/qabstractproxymodel_p.h> |
|
48 |
||
49 |
QT_BEGIN_NAMESPACE |
|
50 |
||
51 |
/*! |
|
52 |
\since 4.1 |
|
53 |
\class QAbstractProxyModel |
|
54 |
\brief The QAbstractProxyModel class provides a base class for proxy item |
|
55 |
models that can do sorting, filtering or other data processing tasks. |
|
56 |
\ingroup model-view |
|
57 |
||
58 |
This class defines the standard interface that proxy models must use to be |
|
59 |
able to interoperate correctly with other model/view components. It is not |
|
60 |
supposed to be instantiated directly. |
|
61 |
||
62 |
All standard proxy models are derived from the QAbstractProxyModel class. |
|
63 |
If you need to create a new proxy model class, it is usually better to |
|
64 |
subclass an existing class that provides the closest behavior to the one |
|
65 |
you want to provide. |
|
66 |
||
67 |
Proxy models that filter or sort items of data from a source model should |
|
68 |
be created by using or subclassing QSortFilterProxyModel. |
|
69 |
||
70 |
To subclass QAbstractProxyModel, you need to implement mapFromSource() and |
|
71 |
mapToSource(). The mapSelectionFromSource() and mapSelectionToSource() |
|
72 |
functions only need to be reimplemented if you need a behavior different |
|
73 |
from the default behavior. |
|
74 |
||
75 |
\note If the source model is deleted or no source model is specified, the |
|
76 |
proxy model operates on a empty placeholder model. |
|
77 |
||
78 |
\sa QSortFilterProxyModel, QAbstractItemModel, {Model/View Programming} |
|
79 |
*/ |
|
80 |
||
81 |
//detects the deletion of the source model |
|
82 |
void QAbstractProxyModelPrivate::_q_sourceModelDestroyed() |
|
83 |
{ |
|
84 |
model = QAbstractItemModelPrivate::staticEmptyModel(); |
|
85 |
} |
|
86 |
||
87 |
/*! |
|
88 |
Constructs a proxy model with the given \a parent. |
|
89 |
*/ |
|
90 |
||
91 |
QAbstractProxyModel::QAbstractProxyModel(QObject *parent) |
|
92 |
:QAbstractItemModel(*new QAbstractProxyModelPrivate, parent) |
|
93 |
{ |
|
94 |
setSourceModel(QAbstractItemModelPrivate::staticEmptyModel()); |
|
95 |
} |
|
96 |
||
97 |
/*! |
|
98 |
\internal |
|
99 |
*/ |
|
100 |
||
101 |
QAbstractProxyModel::QAbstractProxyModel(QAbstractProxyModelPrivate &dd, QObject *parent) |
|
102 |
: QAbstractItemModel(dd, parent) |
|
103 |
{ |
|
104 |
setSourceModel(QAbstractItemModelPrivate::staticEmptyModel()); |
|
105 |
} |
|
106 |
||
107 |
/*! |
|
108 |
Destroys the proxy model. |
|
109 |
*/ |
|
110 |
QAbstractProxyModel::~QAbstractProxyModel() |
|
111 |
{ |
|
112 |
||
113 |
} |
|
114 |
||
115 |
/*! |
|
116 |
Sets the given \a sourceModel to be processed by the proxy model. |
|
117 |
*/ |
|
118 |
void QAbstractProxyModel::setSourceModel(QAbstractItemModel *sourceModel) |
|
119 |
{ |
|
120 |
Q_D(QAbstractProxyModel); |
|
121 |
if (d->model) |
|
122 |
disconnect(d->model, SIGNAL(destroyed()), this, SLOT(_q_sourceModelDestroyed())); |
|
123 |
||
124 |
if (sourceModel) { |
|
125 |
d->model = sourceModel; |
|
126 |
connect(d->model, SIGNAL(destroyed()), this, SLOT(_q_sourceModelDestroyed())); |
|
127 |
} else { |
|
128 |
d->model = QAbstractItemModelPrivate::staticEmptyModel(); |
|
129 |
} |
|
7
3f74d0d4af4c
qt:70947f0f93d948bc89b3b43d00da758a51f1ef84
Eckhart Koeppen <eckhart.koppen@nokia.com>
parents:
4
diff
changeset
|
130 |
d->roleNames = d->model->roleNames(); |
0 | 131 |
} |
132 |
||
133 |
/*! |
|
134 |
Returns the model that contains the data that is available through the proxy model. |
|
135 |
*/ |
|
136 |
QAbstractItemModel *QAbstractProxyModel::sourceModel() const |
|
137 |
{ |
|
138 |
Q_D(const QAbstractProxyModel); |
|
139 |
if (d->model == QAbstractItemModelPrivate::staticEmptyModel()) |
|
140 |
return 0; |
|
141 |
return d->model; |
|
142 |
} |
|
143 |
||
144 |
/*! |
|
145 |
\reimp |
|
146 |
*/ |
|
147 |
bool QAbstractProxyModel::submit() |
|
148 |
{ |
|
149 |
Q_D(QAbstractProxyModel); |
|
150 |
return d->model->submit(); |
|
151 |
} |
|
152 |
||
153 |
/*! |
|
154 |
\reimp |
|
155 |
*/ |
|
156 |
void QAbstractProxyModel::revert() |
|
157 |
{ |
|
158 |
Q_D(QAbstractProxyModel); |
|
159 |
d->model->revert(); |
|
160 |
} |
|
161 |
||
162 |
||
163 |
/*! |
|
164 |
\fn QModelIndex QAbstractProxyModel::mapToSource(const QModelIndex &proxyIndex) const |
|
165 |
||
166 |
Reimplement this function to return the model index in the source model that |
|
167 |
corresponds to the \a proxyIndex in the proxy model. |
|
168 |
||
169 |
\sa mapFromSource() |
|
170 |
*/ |
|
171 |
||
172 |
/*! |
|
173 |
\fn QModelIndex QAbstractProxyModel::mapFromSource(const QModelIndex &sourceIndex) const |
|
174 |
||
175 |
Reimplement this function to return the model index in the proxy model that |
|
176 |
corresponds to the \a sourceIndex from the source model. |
|
177 |
||
178 |
\sa mapToSource() |
|
179 |
*/ |
|
180 |
||
181 |
/*! |
|
182 |
Returns a source selection mapped from the specified \a proxySelection. |
|
183 |
||
184 |
Reimplement this method to map proxy selections to source selections. |
|
185 |
*/ |
|
186 |
QItemSelection QAbstractProxyModel::mapSelectionToSource(const QItemSelection &proxySelection) const |
|
187 |
{ |
|
188 |
QModelIndexList proxyIndexes = proxySelection.indexes(); |
|
189 |
QItemSelection sourceSelection; |
|
190 |
for (int i = 0; i < proxyIndexes.size(); ++i) |
|
191 |
sourceSelection << QItemSelectionRange(mapToSource(proxyIndexes.at(i))); |
|
192 |
return sourceSelection; |
|
193 |
} |
|
194 |
||
195 |
/*! |
|
196 |
Returns a proxy selection mapped from the specified \a sourceSelection. |
|
197 |
||
198 |
Reimplement this method to map source selections to proxy selections. |
|
199 |
*/ |
|
200 |
QItemSelection QAbstractProxyModel::mapSelectionFromSource(const QItemSelection &sourceSelection) const |
|
201 |
{ |
|
202 |
QModelIndexList sourceIndexes = sourceSelection.indexes(); |
|
203 |
QItemSelection proxySelection; |
|
204 |
for (int i = 0; i < sourceIndexes.size(); ++i) |
|
205 |
proxySelection << QItemSelectionRange(mapFromSource(sourceIndexes.at(i))); |
|
206 |
return proxySelection; |
|
207 |
} |
|
208 |
||
209 |
/*! |
|
210 |
\reimp |
|
211 |
*/ |
|
212 |
QVariant QAbstractProxyModel::data(const QModelIndex &proxyIndex, int role) const |
|
213 |
{ |
|
214 |
Q_D(const QAbstractProxyModel); |
|
215 |
return d->model->data(mapToSource(proxyIndex), role); |
|
216 |
} |
|
217 |
||
218 |
/*! |
|
219 |
\reimp |
|
220 |
*/ |
|
221 |
QVariant QAbstractProxyModel::headerData(int section, Qt::Orientation orientation, int role) const |
|
222 |
{ |
|
223 |
Q_D(const QAbstractProxyModel); |
|
224 |
int sourceSection; |
|
225 |
if (orientation == Qt::Horizontal) { |
|
226 |
const QModelIndex proxyIndex = index(0, section); |
|
227 |
sourceSection = mapToSource(proxyIndex).column(); |
|
228 |
} else { |
|
229 |
const QModelIndex proxyIndex = index(section, 0); |
|
230 |
sourceSection = mapToSource(proxyIndex).row(); |
|
231 |
} |
|
232 |
return d->model->headerData(sourceSection, orientation, role); |
|
233 |
} |
|
234 |
||
235 |
/*! |
|
236 |
\reimp |
|
237 |
*/ |
|
238 |
QMap<int, QVariant> QAbstractProxyModel::itemData(const QModelIndex &proxyIndex) const |
|
239 |
{ |
|
240 |
Q_D(const QAbstractProxyModel); |
|
241 |
return d->model->itemData(mapToSource(proxyIndex)); |
|
242 |
} |
|
243 |
||
244 |
/*! |
|
245 |
\reimp |
|
246 |
*/ |
|
247 |
Qt::ItemFlags QAbstractProxyModel::flags(const QModelIndex &index) const |
|
248 |
{ |
|
249 |
Q_D(const QAbstractProxyModel); |
|
250 |
return d->model->flags(mapToSource(index)); |
|
251 |
} |
|
252 |
||
253 |
/*! |
|
254 |
\reimp |
|
255 |
*/ |
|
256 |
bool QAbstractProxyModel::setData(const QModelIndex &index, const QVariant &value, int role) |
|
257 |
{ |
|
258 |
Q_D(QAbstractProxyModel); |
|
259 |
return d->model->setData(mapToSource(index), value, role); |
|
260 |
} |
|
261 |
||
262 |
/*! |
|
263 |
\reimp |
|
264 |
*/ |
|
265 |
bool QAbstractProxyModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role) |
|
266 |
{ |
|
267 |
Q_D(QAbstractProxyModel); |
|
268 |
int sourceSection; |
|
269 |
if (orientation == Qt::Horizontal) { |
|
270 |
const QModelIndex proxyIndex = index(0, section); |
|
271 |
sourceSection = mapToSource(proxyIndex).column(); |
|
272 |
} else { |
|
273 |
const QModelIndex proxyIndex = index(section, 0); |
|
274 |
sourceSection = mapToSource(proxyIndex).row(); |
|
275 |
} |
|
276 |
return d->model->setHeaderData(sourceSection, orientation, value, role); |
|
277 |
} |
|
278 |
||
279 |
QT_END_NAMESPACE |
|
280 |
||
281 |
#include "moc_qabstractproxymodel.cpp" |
|
282 |
||
283 |
#endif // QT_NO_PROXYMODEL |