| 1 | /****************************************************************************
|
|---|
| 2 | **
|
|---|
| 3 | ** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
|
|---|
| 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 | ** Commercial Usage
|
|---|
| 11 | ** Licensees holding valid Qt Commercial licenses may use this file in
|
|---|
| 12 | ** accordance with the Qt Commercial License Agreement provided with the
|
|---|
| 13 | ** Software or, alternatively, in accordance with the terms contained in
|
|---|
| 14 | ** a written agreement between you and Nokia.
|
|---|
| 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 | ** GNU General Public License Usage
|
|---|
| 29 | ** Alternatively, this file may be used under the terms of the GNU
|
|---|
| 30 | ** General Public License version 3.0 as published by the Free Software
|
|---|
| 31 | ** Foundation and appearing in the file LICENSE.GPL included in the
|
|---|
| 32 | ** packaging of this file. Please review the following information to
|
|---|
| 33 | ** ensure the GNU General Public License version 3.0 requirements will be
|
|---|
| 34 | ** met: http://www.gnu.org/copyleft/gpl.html.
|
|---|
| 35 | **
|
|---|
| 36 | ** If you have questions regarding the use of this file, please contact
|
|---|
| 37 | ** Nokia at qt-info@nokia.com.
|
|---|
| 38 | ** $QT_END_LICENSE$
|
|---|
| 39 | **
|
|---|
| 40 | ****************************************************************************/
|
|---|
| 41 |
|
|---|
| 42 | #include "qitemselectionmodel.h"
|
|---|
| 43 | #include <private/qitemselectionmodel_p.h>
|
|---|
| 44 | #include <qdebug.h>
|
|---|
| 45 |
|
|---|
| 46 | #ifndef QT_NO_ITEMVIEWS
|
|---|
| 47 |
|
|---|
| 48 | QT_BEGIN_NAMESPACE
|
|---|
| 49 |
|
|---|
| 50 | /*!
|
|---|
| 51 | \class QItemSelectionRange
|
|---|
| 52 |
|
|---|
| 53 | \brief The QItemSelectionRange class manages information about a
|
|---|
| 54 | range of selected items in a model.
|
|---|
| 55 |
|
|---|
| 56 | \ingroup model-view
|
|---|
| 57 |
|
|---|
| 58 | A QItemSelectionRange contains information about a range of
|
|---|
| 59 | selected items in a model. A range of items is a contiguous array
|
|---|
| 60 | of model items, extending to cover a number of adjacent rows and
|
|---|
| 61 | columns with a common parent item; this can be visualized as a
|
|---|
| 62 | two-dimensional block of cells in a table. A selection range has a
|
|---|
| 63 | top(), left() a bottom(), right() and a parent().
|
|---|
| 64 |
|
|---|
| 65 | The QItemSelectionRange class is one of the \l{Model/View Classes}
|
|---|
| 66 | and is part of Qt's \l{Model/View Programming}{model/view framework}.
|
|---|
| 67 |
|
|---|
| 68 | The model items contained in the selection range can be obtained
|
|---|
| 69 | using the indexes() function. Use QItemSelectionModel::selectedIndexes()
|
|---|
| 70 | to get a list of all selected items for a view.
|
|---|
| 71 |
|
|---|
| 72 | You can determine whether a given model item lies within a
|
|---|
| 73 | particular range by using the contains() function. Ranges can also
|
|---|
| 74 | be compared using the overloaded operators for equality and
|
|---|
| 75 | inequality, and the intersects() function allows you to determine
|
|---|
| 76 | whether two ranges overlap.
|
|---|
| 77 |
|
|---|
| 78 | \sa {Model/View Programming}, QAbstractItemModel, QItemSelection,
|
|---|
| 79 | QItemSelectionModel
|
|---|
| 80 | */
|
|---|
| 81 |
|
|---|
| 82 | /*!
|
|---|
| 83 | \fn QItemSelectionRange::QItemSelectionRange()
|
|---|
| 84 |
|
|---|
| 85 | Constructs an empty selection range.
|
|---|
| 86 | */
|
|---|
| 87 |
|
|---|
| 88 | /*!
|
|---|
| 89 | \fn QItemSelectionRange::QItemSelectionRange(const QItemSelectionRange &other)
|
|---|
| 90 |
|
|---|
| 91 | Copy constructor. Constructs a new selection range with the same contents
|
|---|
| 92 | as the \a other range given.
|
|---|
| 93 |
|
|---|
| 94 | */
|
|---|
| 95 |
|
|---|
| 96 | /*!
|
|---|
| 97 | \fn QItemSelectionRange::QItemSelectionRange(const QModelIndex &topLeft, const QModelIndex &bottomRight)
|
|---|
| 98 |
|
|---|
| 99 | Constructs a new selection range containing only the index specified
|
|---|
| 100 | by the \a topLeft and the index \a bottomRight.
|
|---|
| 101 |
|
|---|
| 102 | */
|
|---|
| 103 |
|
|---|
| 104 | /*!
|
|---|
| 105 | \fn QItemSelectionRange::QItemSelectionRange(const QModelIndex &index)
|
|---|
| 106 |
|
|---|
| 107 | Constructs a new selection range containing only the model item specified
|
|---|
| 108 | by the model index \a index.
|
|---|
| 109 | */
|
|---|
| 110 |
|
|---|
| 111 | /*!
|
|---|
| 112 | \fn int QItemSelectionRange::top() const
|
|---|
| 113 |
|
|---|
| 114 | Returns the row index corresponding to the uppermost selected row in the
|
|---|
| 115 | selection range.
|
|---|
| 116 |
|
|---|
| 117 | */
|
|---|
| 118 |
|
|---|
| 119 | /*!
|
|---|
| 120 | \fn int QItemSelectionRange::left() const
|
|---|
| 121 |
|
|---|
| 122 | Returns the column index corresponding to the leftmost selected column in the
|
|---|
| 123 | selection range.
|
|---|
| 124 | */
|
|---|
| 125 |
|
|---|
| 126 | /*!
|
|---|
| 127 | \fn int QItemSelectionRange::bottom() const
|
|---|
| 128 |
|
|---|
| 129 | Returns the row index corresponding to the lowermost selected row in the
|
|---|
| 130 | selection range.
|
|---|
| 131 |
|
|---|
| 132 | */
|
|---|
| 133 |
|
|---|
| 134 | /*!
|
|---|
| 135 | \fn int QItemSelectionRange::right() const
|
|---|
| 136 |
|
|---|
| 137 | Returns the column index corresponding to the rightmost selected column in
|
|---|
| 138 | the selection range.
|
|---|
| 139 |
|
|---|
| 140 | */
|
|---|
| 141 |
|
|---|
| 142 | /*!
|
|---|
| 143 | \fn int QItemSelectionRange::width() const
|
|---|
| 144 |
|
|---|
| 145 | Returns the number of selected columns in the selection range.
|
|---|
| 146 |
|
|---|
| 147 | */
|
|---|
| 148 |
|
|---|
| 149 | /*!
|
|---|
| 150 | \fn int QItemSelectionRange::height() const
|
|---|
| 151 |
|
|---|
| 152 | Returns the number of selected rows in the selection range.
|
|---|
| 153 |
|
|---|
| 154 | */
|
|---|
| 155 |
|
|---|
| 156 | /*!
|
|---|
| 157 | \fn const QAbstractItemModel *QItemSelectionRange::model() const
|
|---|
| 158 |
|
|---|
| 159 | Returns the model that the items in the selection range belong to.
|
|---|
| 160 | */
|
|---|
| 161 |
|
|---|
| 162 | /*!
|
|---|
| 163 | \fn QModelIndex QItemSelectionRange::topLeft() const
|
|---|
| 164 |
|
|---|
| 165 | Returns the index for the item located at the top-left corner of
|
|---|
| 166 | the selection range.
|
|---|
| 167 |
|
|---|
| 168 | \sa top(), left(), bottomRight()
|
|---|
| 169 | */
|
|---|
| 170 |
|
|---|
| 171 | /*!
|
|---|
| 172 | \fn QModelIndex QItemSelectionRange::bottomRight() const
|
|---|
| 173 |
|
|---|
| 174 | Returns the index for the item located at the bottom-right corner
|
|---|
| 175 | of the selection range.
|
|---|
| 176 |
|
|---|
| 177 | \sa bottom(), right(), topLeft()
|
|---|
| 178 | */
|
|---|
| 179 |
|
|---|
| 180 | /*!
|
|---|
| 181 | \fn QModelIndex QItemSelectionRange::parent() const
|
|---|
| 182 |
|
|---|
| 183 | Returns the parent model item index of the items in the selection range.
|
|---|
| 184 |
|
|---|
| 185 | */
|
|---|
| 186 |
|
|---|
| 187 | /*!
|
|---|
| 188 | \fn bool QItemSelectionRange::contains(const QModelIndex &index) const
|
|---|
| 189 |
|
|---|
| 190 | Returns true if the model item specified by the \a index lies within the
|
|---|
| 191 | range of selected items; otherwise returns false.
|
|---|
| 192 | */
|
|---|
| 193 |
|
|---|
| 194 | /*!
|
|---|
| 195 | \fn bool QItemSelectionRange::contains(int row, int column,
|
|---|
| 196 | const QModelIndex &parentIndex) const
|
|---|
| 197 | \overload
|
|---|
| 198 |
|
|---|
| 199 | Returns true if the model item specified by (\a row, \a column)
|
|---|
| 200 | and with \a parentIndex as the parent item lies within the range
|
|---|
| 201 | of selected items; otherwise returns false.
|
|---|
| 202 | */
|
|---|
| 203 |
|
|---|
| 204 | /*!
|
|---|
| 205 | \fn bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
|
|---|
| 206 |
|
|---|
| 207 | Returns true if this selection range intersects (overlaps with) the \a other
|
|---|
| 208 | range given; otherwise returns false.
|
|---|
| 209 |
|
|---|
| 210 | */
|
|---|
| 211 | bool QItemSelectionRange::intersects(const QItemSelectionRange &other) const
|
|---|
| 212 | {
|
|---|
| 213 | return (isValid() && other.isValid()
|
|---|
| 214 | && parent() == other.parent()
|
|---|
| 215 | && ((top() <= other.top() && bottom() >= other.top())
|
|---|
| 216 | || (top() >= other.top() && top() <= other.bottom()))
|
|---|
| 217 | && ((left() <= other.left() && right() >= other.left())
|
|---|
| 218 | || (left() >= other.left() && left() <= other.right())));
|
|---|
| 219 | }
|
|---|
| 220 |
|
|---|
| 221 | /*!
|
|---|
| 222 | \fn QItemSelectionRange QItemSelectionRange::intersect(const QItemSelectionRange &other) const
|
|---|
| 223 | \obsolete
|
|---|
| 224 |
|
|---|
| 225 | Use intersected(\a other) instead.
|
|---|
| 226 | */
|
|---|
| 227 |
|
|---|
| 228 | /*!
|
|---|
| 229 | \fn QItemSelectionRange QItemSelectionRange::intersected(const QItemSelectionRange &other) const
|
|---|
| 230 | \since 4.2
|
|---|
| 231 |
|
|---|
| 232 | Returns a new selection range containing only the items that are found in
|
|---|
| 233 | both the selection range and the \a other selection range.
|
|---|
| 234 | */
|
|---|
| 235 |
|
|---|
| 236 | QItemSelectionRange QItemSelectionRange::intersect(const QItemSelectionRange &other) const
|
|---|
| 237 | {
|
|---|
| 238 | if (model() == other.model() && parent() == other.parent()) {
|
|---|
| 239 | QModelIndex topLeft = model()->index(qMax(top(), other.top()),
|
|---|
| 240 | qMax(left(), other.left()),
|
|---|
| 241 | other.parent());
|
|---|
| 242 | QModelIndex bottomRight = model()->index(qMin(bottom(), other.bottom()),
|
|---|
| 243 | qMin(right(), other.right()),
|
|---|
| 244 | other.parent());
|
|---|
| 245 | return QItemSelectionRange(topLeft, bottomRight);
|
|---|
| 246 | }
|
|---|
| 247 | return QItemSelectionRange();
|
|---|
| 248 | }
|
|---|
| 249 |
|
|---|
| 250 | /*!
|
|---|
| 251 | \fn bool QItemSelectionRange::operator==(const QItemSelectionRange &other) const
|
|---|
| 252 |
|
|---|
| 253 | Returns true if the selection range is exactly the same as the \a other
|
|---|
| 254 | range given; otherwise returns false.
|
|---|
| 255 |
|
|---|
| 256 | */
|
|---|
| 257 |
|
|---|
| 258 | /*!
|
|---|
| 259 | \fn bool QItemSelectionRange::operator!=(const QItemSelectionRange &other) const
|
|---|
| 260 |
|
|---|
| 261 | Returns true if the selection range differs from the \a other range given;
|
|---|
| 262 | otherwise returns false.
|
|---|
| 263 |
|
|---|
| 264 | */
|
|---|
| 265 |
|
|---|
| 266 | /*!
|
|---|
| 267 | \fn bool QItemSelectionRange::isValid() const
|
|---|
| 268 |
|
|---|
| 269 | Returns true if the selection range is valid; otherwise returns false.
|
|---|
| 270 |
|
|---|
| 271 | */
|
|---|
| 272 |
|
|---|
| 273 | /*
|
|---|
| 274 | \internal
|
|---|
| 275 |
|
|---|
| 276 | utility function for getting the indexes from a range
|
|---|
| 277 | it avoid concatenating list and works on one
|
|---|
| 278 | */
|
|---|
| 279 |
|
|---|
| 280 | static void indexesFromRange(const QItemSelectionRange &range, QModelIndexList &result)
|
|---|
| 281 | {
|
|---|
| 282 | if (range.isValid() && range.model()) {
|
|---|
| 283 | for (int column = range.left(); column <= range.right(); ++column) {
|
|---|
| 284 | for (int row = range.top(); row <= range.bottom(); ++row) {
|
|---|
| 285 | QModelIndex index = range.model()->index(row, column, range.parent());
|
|---|
| 286 | Qt::ItemFlags flags = range.model()->flags(index);
|
|---|
| 287 | if ((flags & Qt::ItemIsSelectable) && (flags & Qt::ItemIsEnabled))
|
|---|
| 288 | result.append(index);
|
|---|
| 289 | }
|
|---|
| 290 | }
|
|---|
| 291 | }
|
|---|
| 292 | }
|
|---|
| 293 |
|
|---|
| 294 | /*!
|
|---|
| 295 | Returns the list of model index items stored in the selection.
|
|---|
| 296 | */
|
|---|
| 297 |
|
|---|
| 298 | QModelIndexList QItemSelectionRange::indexes() const
|
|---|
| 299 | {
|
|---|
| 300 | QModelIndexList result;
|
|---|
| 301 | indexesFromRange(*this, result);
|
|---|
| 302 | return result;
|
|---|
| 303 | }
|
|---|
| 304 |
|
|---|
| 305 | /*!
|
|---|
| 306 | \class QItemSelection
|
|---|
| 307 |
|
|---|
| 308 | \brief The QItemSelection class manages information about selected items in a model.
|
|---|
| 309 |
|
|---|
| 310 | \ingroup model-view
|
|---|
| 311 |
|
|---|
| 312 | A QItemSelection describes the items in a model that have been
|
|---|
| 313 | selected by the user. A QItemSelection is basically a list of
|
|---|
| 314 | selection ranges, see QItemSelectionRange. It provides functions for
|
|---|
| 315 | creating and manipulating selections, and selecting a range of items
|
|---|
| 316 | from a model.
|
|---|
| 317 |
|
|---|
| 318 | The QItemSelection class is one of the \l{Model/View Classes}
|
|---|
| 319 | and is part of Qt's \l{Model/View Programming}{model/view framework}.
|
|---|
| 320 |
|
|---|
| 321 | An item selection can be constructed and initialized to contain a
|
|---|
| 322 | range of items from an existing model. The following example constructs
|
|---|
| 323 | a selection that contains a range of items from the given \c model,
|
|---|
| 324 | beginning at the \c topLeft, and ending at the \c bottomRight.
|
|---|
| 325 |
|
|---|
| 326 | \snippet doc/src/snippets/code/src_gui_itemviews_qitemselectionmodel.cpp 0
|
|---|
| 327 |
|
|---|
| 328 | An empty item selection can be constructed, and later populated as
|
|---|
| 329 | required. So, if the model is going to be unavailable when we construct
|
|---|
| 330 | the item selection, we can rewrite the above code in the following way:
|
|---|
| 331 |
|
|---|
| 332 | \snippet doc/src/snippets/code/src_gui_itemviews_qitemselectionmodel.cpp 1
|
|---|
| 333 |
|
|---|
| 334 | QItemSelection saves memory, and avoids unnecessary work, by working with
|
|---|
| 335 | selection ranges rather than recording the model item index for each
|
|---|
| 336 | item in the selection. Generally, an instance of this class will contain
|
|---|
| 337 | a list of non-overlapping selection ranges.
|
|---|
| 338 |
|
|---|
| 339 | Use merge() to merge one item selection into another without making
|
|---|
| 340 | overlapping ranges. Use split() to split one selection range into
|
|---|
| 341 | smaller ranges based on a another selection range.
|
|---|
| 342 |
|
|---|
| 343 | \sa {Model/View Programming}, QItemSelectionModel
|
|---|
| 344 | */
|
|---|
| 345 |
|
|---|
| 346 | /*!
|
|---|
| 347 | \fn QItemSelection::QItemSelection()
|
|---|
| 348 |
|
|---|
| 349 | Constructs an empty selection.
|
|---|
| 350 | */
|
|---|
| 351 |
|
|---|
| 352 | /*!
|
|---|
| 353 | Constructs an item selection that extends from the top-left model item,
|
|---|
| 354 | specified by the \a topLeft index, to the bottom-right item, specified
|
|---|
| 355 | by \a bottomRight.
|
|---|
| 356 | */
|
|---|
| 357 | QItemSelection::QItemSelection(const QModelIndex &topLeft, const QModelIndex &bottomRight)
|
|---|
| 358 | {
|
|---|
| 359 | select(topLeft, bottomRight);
|
|---|
| 360 | }
|
|---|
| 361 |
|
|---|
| 362 | /*!
|
|---|
| 363 | Adds the items in the range that extends from the top-left model
|
|---|
| 364 | item, specified by the \a topLeft index, to the bottom-right item,
|
|---|
| 365 | specified by \a bottomRight to the list.
|
|---|
| 366 |
|
|---|
| 367 | \note \a topLeft and \a bottomRight must have the same parent.
|
|---|
| 368 | */
|
|---|
| 369 | void QItemSelection::select(const QModelIndex &topLeft, const QModelIndex &bottomRight)
|
|---|
| 370 | {
|
|---|
| 371 | if (!topLeft.isValid() || !bottomRight.isValid())
|
|---|
| 372 | return;
|
|---|
| 373 |
|
|---|
| 374 | if ((topLeft.model() != bottomRight.model())
|
|---|
| 375 | || topLeft.parent() != bottomRight.parent()) {
|
|---|
| 376 | qWarning("Can't select indexes from different model or with different parents");
|
|---|
| 377 | return;
|
|---|
| 378 | }
|
|---|
| 379 | if (topLeft.row() > bottomRight.row() || topLeft.column() > bottomRight.column()) {
|
|---|
| 380 | int top = qMin(topLeft.row(), bottomRight.row());
|
|---|
| 381 | int bottom = qMax(topLeft.row(), bottomRight.row());
|
|---|
| 382 | int left = qMin(topLeft.column(), bottomRight.column());
|
|---|
| 383 | int right = qMax(topLeft.column(), bottomRight.column());
|
|---|
| 384 | QModelIndex tl = topLeft.sibling(top, left);
|
|---|
| 385 | QModelIndex br = bottomRight.sibling(bottom, right);
|
|---|
| 386 | append(QItemSelectionRange(tl, br));
|
|---|
| 387 | return;
|
|---|
| 388 | }
|
|---|
| 389 | append(QItemSelectionRange(topLeft, bottomRight));
|
|---|
| 390 | }
|
|---|
| 391 |
|
|---|
| 392 | /*!
|
|---|
| 393 | Returns true if the selection contains the given \a index; otherwise
|
|---|
| 394 | returns false.
|
|---|
| 395 | */
|
|---|
| 396 |
|
|---|
| 397 | bool QItemSelection::contains(const QModelIndex &index) const
|
|---|
| 398 | {
|
|---|
| 399 | if (index.flags() & Qt::ItemIsSelectable) {
|
|---|
| 400 | QList<QItemSelectionRange>::const_iterator it = begin();
|
|---|
| 401 | for (; it != end(); ++it)
|
|---|
| 402 | if ((*it).contains(index))
|
|---|
| 403 | return true;
|
|---|
| 404 | }
|
|---|
| 405 | return false;
|
|---|
| 406 | }
|
|---|
| 407 |
|
|---|
| 408 | /*!
|
|---|
| 409 | Returns a list of model indexes that correspond to the selected items.
|
|---|
| 410 | */
|
|---|
| 411 |
|
|---|
| 412 | QModelIndexList QItemSelection::indexes() const
|
|---|
| 413 | {
|
|---|
| 414 | QModelIndexList result;
|
|---|
| 415 | QList<QItemSelectionRange>::const_iterator it = begin();
|
|---|
| 416 | for (; it != end(); ++it)
|
|---|
| 417 | indexesFromRange(*it, result);
|
|---|
| 418 | return result;
|
|---|
| 419 | }
|
|---|
| 420 |
|
|---|
| 421 | /*!
|
|---|
| 422 | Merges the \a other selection with this QItemSelection using the
|
|---|
| 423 | \a command given. This method guarantees that no ranges are overlapping.
|
|---|
| 424 |
|
|---|
| 425 | Note that only QItemSelectionModel::Select,
|
|---|
| 426 | QItemSelectionModel::Deselect, and QItemSelectionModel::Toggle are
|
|---|
| 427 | supported.
|
|---|
| 428 |
|
|---|
| 429 | \sa split()
|
|---|
| 430 | */
|
|---|
| 431 | void QItemSelection::merge(const QItemSelection &other, QItemSelectionModel::SelectionFlags command)
|
|---|
| 432 | {
|
|---|
| 433 | if (other.isEmpty() ||
|
|---|
| 434 | !(command & QItemSelectionModel::Select ||
|
|---|
| 435 | command & QItemSelectionModel::Deselect ||
|
|---|
| 436 | command & QItemSelectionModel::Toggle))
|
|---|
| 437 | return;
|
|---|
| 438 |
|
|---|
| 439 | QItemSelection newSelection = other;
|
|---|
| 440 | // Collect intersections
|
|---|
| 441 | QItemSelection intersections;
|
|---|
| 442 | QItemSelection::iterator it = newSelection.begin();
|
|---|
| 443 | while (it != newSelection.end()) {
|
|---|
| 444 | if (!(*it).isValid()) {
|
|---|
| 445 | it = newSelection.erase(it);
|
|---|
| 446 | continue;
|
|---|
| 447 | }
|
|---|
| 448 | for (int t = 0; t < count(); ++t) {
|
|---|
| 449 | if ((*it).intersects(at(t)))
|
|---|
| 450 | intersections.append(at(t).intersected(*it));
|
|---|
| 451 | }
|
|---|
| 452 | ++it;
|
|---|
| 453 | }
|
|---|
| 454 |
|
|---|
| 455 | // Split the old (and new) ranges using the intersections
|
|---|
| 456 | for (int i = 0; i < intersections.count(); ++i) { // for each intersection
|
|---|
| 457 | for (int t = 0; t < count();) { // splitt each old range
|
|---|
| 458 | if (at(t).intersects(intersections.at(i))) {
|
|---|
| 459 | split(at(t), intersections.at(i), this);
|
|---|
| 460 | removeAt(t);
|
|---|
| 461 | } else {
|
|---|
| 462 | ++t;
|
|---|
| 463 | }
|
|---|
| 464 | }
|
|---|
| 465 | // only split newSelection if Toggle is specified
|
|---|
| 466 | for (int n = 0; (command & QItemSelectionModel::Toggle) && n < newSelection.count();) {
|
|---|
| 467 | if (newSelection.at(n).intersects(intersections.at(i))) {
|
|---|
| 468 | split(newSelection.at(n), intersections.at(i), &newSelection);
|
|---|
| 469 | newSelection.removeAt(n);
|
|---|
| 470 | } else {
|
|---|
| 471 | ++n;
|
|---|
| 472 | }
|
|---|
| 473 | }
|
|---|
| 474 | }
|
|---|
| 475 | // do not add newSelection for Deselect
|
|---|
| 476 | if (!(command & QItemSelectionModel::Deselect))
|
|---|
| 477 | operator+=(newSelection);
|
|---|
| 478 | }
|
|---|
| 479 |
|
|---|
| 480 | /*!
|
|---|
| 481 | Splits the selection \a range using the selection \a other range.
|
|---|
| 482 | Removes all items in \a other from \a range and puts the result in \a result.
|
|---|
| 483 | This can be compared with the semantics of the \e subtract operation of a set.
|
|---|
| 484 | \sa merge()
|
|---|
| 485 | */
|
|---|
| 486 |
|
|---|
| 487 | void QItemSelection::split(const QItemSelectionRange &range,
|
|---|
| 488 | const QItemSelectionRange &other, QItemSelection *result)
|
|---|
| 489 | {
|
|---|
| 490 | if (range.parent() != other.parent())
|
|---|
| 491 | return;
|
|---|
| 492 |
|
|---|
| 493 | QModelIndex parent = other.parent();
|
|---|
| 494 | int top = range.top();
|
|---|
| 495 | int left = range.left();
|
|---|
| 496 | int bottom = range.bottom();
|
|---|
| 497 | int right = range.right();
|
|---|
| 498 | int other_top = other.top();
|
|---|
| 499 | int other_left = other.left();
|
|---|
| 500 | int other_bottom = other.bottom();
|
|---|
| 501 | int other_right = other.right();
|
|---|
| 502 | const QAbstractItemModel *model = range.model();
|
|---|
| 503 | Q_ASSERT(model);
|
|---|
| 504 | if (other_top > top) {
|
|---|
| 505 | QModelIndex tl = model->index(top, left, parent);
|
|---|
| 506 | QModelIndex br = model->index(other_top - 1, right, parent);
|
|---|
| 507 | result->append(QItemSelectionRange(tl, br));
|
|---|
| 508 | top = other_top;
|
|---|
| 509 | }
|
|---|
| 510 | if (other_bottom < bottom) {
|
|---|
| 511 | QModelIndex tl = model->index(other_bottom + 1, left, parent);
|
|---|
| 512 | QModelIndex br = model->index(bottom, right, parent);
|
|---|
| 513 | result->append(QItemSelectionRange(tl, br));
|
|---|
| 514 | bottom = other_bottom;
|
|---|
| 515 | }
|
|---|
| 516 | if (other_left > left) {
|
|---|
| 517 | QModelIndex tl = model->index(top, left, parent);
|
|---|
| 518 | QModelIndex br = model->index(bottom, other_left - 1, parent);
|
|---|
| 519 | result->append(QItemSelectionRange(tl, br));
|
|---|
| 520 | left = other_left;
|
|---|
| 521 | }
|
|---|
| 522 | if (other_right < right) {
|
|---|
| 523 | QModelIndex tl = model->index(top, other_right + 1, parent);
|
|---|
| 524 | QModelIndex br = model->index(bottom, right, parent);
|
|---|
| 525 | result->append(QItemSelectionRange(tl, br));
|
|---|
| 526 | right = other_right;
|
|---|
| 527 | }
|
|---|
| 528 | }
|
|---|
| 529 |
|
|---|
| 530 | /*!
|
|---|
| 531 | \internal
|
|---|
| 532 |
|
|---|
| 533 | returns a QItemSelection where all ranges have been expanded to:
|
|---|
| 534 | Rows: left: 0 and right: columnCount()-1
|
|---|
| 535 | Columns: top: 0 and bottom: rowCount()-1
|
|---|
| 536 | */
|
|---|
| 537 |
|
|---|
| 538 | QItemSelection QItemSelectionModelPrivate::expandSelection(const QItemSelection &selection,
|
|---|
| 539 | QItemSelectionModel::SelectionFlags command) const
|
|---|
| 540 | {
|
|---|
| 541 | if (selection.isEmpty() && !((command & QItemSelectionModel::Rows) ||
|
|---|
| 542 | (command & QItemSelectionModel::Columns)))
|
|---|
| 543 | return selection;
|
|---|
| 544 |
|
|---|
| 545 | QItemSelection expanded;
|
|---|
| 546 | if (command & QItemSelectionModel::Rows) {
|
|---|
| 547 | for (int i = 0; i < selection.count(); ++i) {
|
|---|
| 548 | QModelIndex parent = selection.at(i).parent();
|
|---|
| 549 | int colCount = model->columnCount(parent);
|
|---|
| 550 | QModelIndex tl = model->index(selection.at(i).top(), 0, parent);
|
|---|
| 551 | QModelIndex br = model->index(selection.at(i).bottom(), colCount - 1, parent);
|
|---|
| 552 | //we need to merge because the same row could have already been inserted
|
|---|
| 553 | expanded.merge(QItemSelection(tl, br), QItemSelectionModel::Select);
|
|---|
| 554 | }
|
|---|
| 555 | }
|
|---|
| 556 | if (command & QItemSelectionModel::Columns) {
|
|---|
| 557 | for (int i = 0; i < selection.count(); ++i) {
|
|---|
| 558 | QModelIndex parent = selection.at(i).parent();
|
|---|
| 559 | int rowCount = model->rowCount(parent);
|
|---|
| 560 | QModelIndex tl = model->index(0, selection.at(i).left(), parent);
|
|---|
| 561 | QModelIndex br = model->index(rowCount - 1, selection.at(i).right(), parent);
|
|---|
| 562 | //we need to merge because the same column could have already been inserted
|
|---|
| 563 | expanded.merge(QItemSelection(tl, br), QItemSelectionModel::Select);
|
|---|
| 564 | }
|
|---|
| 565 | }
|
|---|
| 566 | return expanded;
|
|---|
| 567 | }
|
|---|
| 568 |
|
|---|
| 569 | /*!
|
|---|
| 570 | \internal
|
|---|
| 571 | */
|
|---|
| 572 | void QItemSelectionModelPrivate::_q_rowsAboutToBeRemoved(const QModelIndex &parent,
|
|---|
| 573 | int start, int end)
|
|---|
| 574 | {
|
|---|
| 575 | Q_Q(QItemSelectionModel);
|
|---|
| 576 | finalize();
|
|---|
| 577 |
|
|---|
| 578 | // update current index
|
|---|
| 579 | if (currentIndex.isValid() && parent == currentIndex.parent()
|
|---|
| 580 | && currentIndex.row() >= start && currentIndex.row() <= end) {
|
|---|
| 581 | QModelIndex old = currentIndex;
|
|---|
| 582 | if (start > 0) // there are rows left above the change
|
|---|
| 583 | currentIndex = model->index(start - 1, old.column(), parent);
|
|---|
| 584 | else if (model && end < model->rowCount(parent) - 1) // there are rows left below the change
|
|---|
| 585 | currentIndex = model->index(end + 1, old.column(), parent);
|
|---|
| 586 | else // there are no rows left in the table
|
|---|
| 587 | currentIndex = QModelIndex();
|
|---|
| 588 | emit q->currentChanged(currentIndex, old);
|
|---|
| 589 | emit q->currentRowChanged(currentIndex, old);
|
|---|
| 590 | if (currentIndex.column() != old.column())
|
|---|
| 591 | emit q->currentColumnChanged(currentIndex, old);
|
|---|
| 592 | }
|
|---|
| 593 |
|
|---|
| 594 | QItemSelection deselected;
|
|---|
| 595 | QItemSelection::iterator it = ranges.begin();
|
|---|
| 596 | while (it != ranges.end()) {
|
|---|
| 597 | if (it->topLeft().parent() != parent) { // Check parents until reaching root or contained in range
|
|---|
| 598 | QModelIndex itParent = it->topLeft().parent();
|
|---|
| 599 | while (itParent.isValid() && itParent.parent() != parent)
|
|---|
| 600 | itParent = itParent.parent();
|
|---|
| 601 |
|
|---|
| 602 | if (itParent.isValid() && start <= itParent.row() && itParent.row() <= end) {
|
|---|
| 603 | deselected.append(*it);
|
|---|
| 604 | it = ranges.erase(it);
|
|---|
| 605 | } else {
|
|---|
| 606 | ++it;
|
|---|
| 607 | }
|
|---|
| 608 | } else if (start <= it->bottom() && it->bottom() <= end // Full inclusion
|
|---|
| 609 | && start <= it->top() && it->top() <= end) {
|
|---|
| 610 | deselected.append(*it);
|
|---|
| 611 | it = ranges.erase(it);
|
|---|
| 612 | } else if (start <= it->top() && it->top() <= end) { // Top intersection
|
|---|
| 613 | deselected.append(QItemSelectionRange(it->topLeft(), model->index(end, it->left(), it->parent())));
|
|---|
| 614 | *it = QItemSelectionRange(model->index(end + 1, it->left(), it->parent()), it->bottomRight());
|
|---|
| 615 | ++it;
|
|---|
| 616 | } else if (start <= it->bottom() && it->bottom() <= end) { // Bottom intersection
|
|---|
| 617 | deselected.append(QItemSelectionRange(model->index(start, it->right(), it->parent()), it->bottomRight()));
|
|---|
| 618 | *it = QItemSelectionRange(it->topLeft(), model->index(start - 1, it->right(), it->parent()));
|
|---|
| 619 | ++it;
|
|---|
| 620 | } else {
|
|---|
| 621 | if (it->top() < start && end < it->bottom()) // Middle intersection (do nothing)
|
|---|
| 622 | deselected.append(QItemSelectionRange(model->index(start, it->right(), it->parent()),
|
|---|
| 623 | model->index(end, it->left(), it->parent())));
|
|---|
| 624 | ++it;
|
|---|
| 625 | }
|
|---|
| 626 | }
|
|---|
| 627 |
|
|---|
| 628 | if (!deselected.isEmpty())
|
|---|
| 629 | emit q->selectionChanged(QItemSelection(), deselected);
|
|---|
| 630 | }
|
|---|
| 631 |
|
|---|
| 632 | /*!
|
|---|
| 633 | \internal
|
|---|
| 634 | */
|
|---|
| 635 | void QItemSelectionModelPrivate::_q_columnsAboutToBeRemoved(const QModelIndex &parent,
|
|---|
| 636 | int start, int end)
|
|---|
| 637 | {
|
|---|
| 638 | Q_Q(QItemSelectionModel);
|
|---|
| 639 |
|
|---|
| 640 | // update current index
|
|---|
| 641 | if (currentIndex.isValid() && parent == currentIndex.parent()
|
|---|
| 642 | && currentIndex.column() >= start && currentIndex.column() <= end) {
|
|---|
| 643 | QModelIndex old = currentIndex;
|
|---|
| 644 | if (start > 0) // there are columns to the left of the change
|
|---|
| 645 | currentIndex = model->index(old.row(), start - 1, parent);
|
|---|
| 646 | else if (model && end < model->columnCount() - 1) // there are columns to the right of the change
|
|---|
| 647 | currentIndex = model->index(old.row(), end + 1, parent);
|
|---|
| 648 | else // there are no columns left in the table
|
|---|
| 649 | currentIndex = QModelIndex();
|
|---|
| 650 | emit q->currentChanged(currentIndex, old);
|
|---|
| 651 | if (currentIndex.row() != old.row())
|
|---|
| 652 | emit q->currentRowChanged(currentIndex, old);
|
|---|
| 653 | emit q->currentColumnChanged(currentIndex, old);
|
|---|
| 654 | }
|
|---|
| 655 |
|
|---|
| 656 | // update selections
|
|---|
| 657 | QModelIndex tl = model->index(0, start, parent);
|
|---|
| 658 | QModelIndex br = model->index(model->rowCount(parent) - 1, end, parent);
|
|---|
| 659 | q->select(QItemSelection(tl, br), QItemSelectionModel::Deselect);
|
|---|
| 660 | finalize();
|
|---|
| 661 | }
|
|---|
| 662 |
|
|---|
| 663 | /*!
|
|---|
| 664 | \internal
|
|---|
| 665 |
|
|---|
| 666 | Split selection ranges if columns are about to be inserted in the middle.
|
|---|
| 667 | */
|
|---|
| 668 | void QItemSelectionModelPrivate::_q_columnsAboutToBeInserted(const QModelIndex &parent,
|
|---|
| 669 | int start, int end)
|
|---|
| 670 | {
|
|---|
| 671 | Q_UNUSED(end);
|
|---|
| 672 | finalize();
|
|---|
| 673 | QList<QItemSelectionRange> split;
|
|---|
| 674 | QList<QItemSelectionRange>::iterator it = ranges.begin();
|
|---|
| 675 | for (; it != ranges.end(); ) {
|
|---|
| 676 | if ((*it).isValid() && (*it).parent() == parent
|
|---|
| 677 | && (*it).left() < start && (*it).right() >= start) {
|
|---|
| 678 | QModelIndex bottomMiddle = model->index((*it).bottom(), start - 1, (*it).parent());
|
|---|
| 679 | QItemSelectionRange left((*it).topLeft(), bottomMiddle);
|
|---|
| 680 | QModelIndex topMiddle = model->index((*it).top(), start, (*it).parent());
|
|---|
| 681 | QItemSelectionRange right(topMiddle, (*it).bottomRight());
|
|---|
| 682 | it = ranges.erase(it);
|
|---|
| 683 | split.append(left);
|
|---|
| 684 | split.append(right);
|
|---|
| 685 | } else {
|
|---|
| 686 | ++it;
|
|---|
| 687 | }
|
|---|
| 688 | }
|
|---|
| 689 | ranges += split;
|
|---|
| 690 | }
|
|---|
| 691 |
|
|---|
| 692 | /*!
|
|---|
| 693 | \internal
|
|---|
| 694 |
|
|---|
| 695 | Split selection ranges if rows are about to be inserted in the middle.
|
|---|
| 696 | */
|
|---|
| 697 | void QItemSelectionModelPrivate::_q_rowsAboutToBeInserted(const QModelIndex &parent,
|
|---|
| 698 | int start, int end)
|
|---|
| 699 | {
|
|---|
| 700 | Q_UNUSED(end);
|
|---|
| 701 | finalize();
|
|---|
| 702 | QList<QItemSelectionRange> split;
|
|---|
| 703 | QList<QItemSelectionRange>::iterator it = ranges.begin();
|
|---|
| 704 | for (; it != ranges.end(); ) {
|
|---|
| 705 | if ((*it).isValid() && (*it).parent() == parent
|
|---|
| 706 | && (*it).top() < start && (*it).bottom() >= start) {
|
|---|
| 707 | QModelIndex middleRight = model->index(start - 1, (*it).right(), (*it).parent());
|
|---|
| 708 | QItemSelectionRange top((*it).topLeft(), middleRight);
|
|---|
| 709 | QModelIndex middleLeft = model->index(start, (*it).left(), (*it).parent());
|
|---|
| 710 | QItemSelectionRange bottom(middleLeft, (*it).bottomRight());
|
|---|
| 711 | it = ranges.erase(it);
|
|---|
| 712 | split.append(top);
|
|---|
| 713 | split.append(bottom);
|
|---|
| 714 | } else {
|
|---|
| 715 | ++it;
|
|---|
| 716 | }
|
|---|
| 717 | }
|
|---|
| 718 | ranges += split;
|
|---|
| 719 | }
|
|---|
| 720 |
|
|---|
| 721 | /*!
|
|---|
| 722 | \internal
|
|---|
| 723 |
|
|---|
| 724 | Split selection into individual (persistent) indexes. This is done in
|
|---|
| 725 | preparation for the layoutChanged() signal, where the indexes can be
|
|---|
| 726 | merged again.
|
|---|
| 727 | */
|
|---|
| 728 | void QItemSelectionModelPrivate::_q_layoutAboutToBeChanged()
|
|---|
| 729 | {
|
|---|
| 730 | savedPersistentIndexes.clear();
|
|---|
| 731 | savedPersistentCurrentIndexes.clear();
|
|---|
| 732 |
|
|---|
| 733 | // optimisation for when all indexes are selected
|
|---|
| 734 | // (only if there is lots of items (1000) because this is not entirely correct)
|
|---|
| 735 | if (ranges.isEmpty() && currentSelection.count() == 1) {
|
|---|
| 736 | QItemSelectionRange range = currentSelection.first();
|
|---|
| 737 | QModelIndex parent = range.parent();
|
|---|
| 738 | tableRowCount = model->rowCount(parent);
|
|---|
| 739 | tableColCount = model->columnCount(parent);
|
|---|
| 740 | if (tableRowCount * tableColCount > 1000
|
|---|
| 741 | && range.top() == 0
|
|---|
| 742 | && range.left() == 0
|
|---|
| 743 | && range.bottom() == tableRowCount - 1
|
|---|
| 744 | && range.right() == tableColCount - 1) {
|
|---|
| 745 | tableSelected = true;
|
|---|
| 746 | tableParent = parent;
|
|---|
| 747 | return;
|
|---|
| 748 | }
|
|---|
| 749 | }
|
|---|
| 750 | tableSelected = false;
|
|---|
| 751 |
|
|---|
| 752 | QModelIndexList indexes = ranges.indexes();
|
|---|
| 753 | QModelIndexList::const_iterator it;
|
|---|
| 754 | for (it = indexes.constBegin(); it != indexes.constEnd(); ++it)
|
|---|
| 755 | savedPersistentIndexes.append(QPersistentModelIndex(*it));
|
|---|
| 756 | indexes = currentSelection.indexes();
|
|---|
| 757 | for (it = indexes.constBegin(); it != indexes.constEnd(); ++it)
|
|---|
| 758 | savedPersistentCurrentIndexes.append(QPersistentModelIndex(*it));
|
|---|
| 759 | }
|
|---|
| 760 |
|
|---|
| 761 | /*!
|
|---|
| 762 | \internal
|
|---|
| 763 |
|
|---|
| 764 | Merges \a indexes into an item selection made up of ranges.
|
|---|
| 765 | Assumes that the indexes are sorted.
|
|---|
| 766 | */
|
|---|
| 767 | static QItemSelection mergeIndexes(const QList<QPersistentModelIndex> &indexes)
|
|---|
| 768 | {
|
|---|
| 769 | QItemSelection colSpans;
|
|---|
| 770 | // merge columns
|
|---|
| 771 | int i = 0;
|
|---|
| 772 | while (i < indexes.count()) {
|
|---|
| 773 | QModelIndex tl = indexes.at(i);
|
|---|
| 774 | QModelIndex br = tl;
|
|---|
| 775 | while (++i < indexes.count()) {
|
|---|
| 776 | QModelIndex next = indexes.at(i);
|
|---|
| 777 | if ((next.parent() == br.parent())
|
|---|
| 778 | && (next.row() == br.row())
|
|---|
| 779 | && (next.column() == br.column() + 1))
|
|---|
| 780 | br = next;
|
|---|
| 781 | else
|
|---|
| 782 | break;
|
|---|
| 783 | }
|
|---|
| 784 | colSpans.append(QItemSelectionRange(tl, br));
|
|---|
| 785 | }
|
|---|
| 786 | // merge rows
|
|---|
| 787 | QItemSelection rowSpans;
|
|---|
| 788 | i = 0;
|
|---|
| 789 | while (i < colSpans.count()) {
|
|---|
| 790 | QModelIndex tl = colSpans.at(i).topLeft();
|
|---|
| 791 | QModelIndex br = colSpans.at(i).bottomRight();
|
|---|
| 792 | QModelIndex prevTl = tl;
|
|---|
| 793 | while (++i < colSpans.count()) {
|
|---|
| 794 | QModelIndex nextTl = colSpans.at(i).topLeft();
|
|---|
| 795 | QModelIndex nextBr = colSpans.at(i).bottomRight();
|
|---|
| 796 | if ((nextTl.column() == prevTl.column()) && (nextBr.column() == br.column())
|
|---|
| 797 | && (nextTl.row() == prevTl.row() + 1) && (nextBr.row() == br.row() + 1)) {
|
|---|
| 798 | br = nextBr;
|
|---|
| 799 | prevTl = nextTl;
|
|---|
| 800 | } else {
|
|---|
| 801 | break;
|
|---|
| 802 | }
|
|---|
| 803 | }
|
|---|
| 804 | rowSpans.append(QItemSelectionRange(tl, br));
|
|---|
| 805 | }
|
|---|
| 806 | return rowSpans;
|
|---|
| 807 | }
|
|---|
| 808 |
|
|---|
| 809 | /*!
|
|---|
| 810 | \internal
|
|---|
| 811 |
|
|---|
| 812 | Merge the selected indexes into selection ranges again.
|
|---|
| 813 | */
|
|---|
| 814 | void QItemSelectionModelPrivate::_q_layoutChanged()
|
|---|
| 815 | {
|
|---|
| 816 | // special case for when all indexes are selected
|
|---|
| 817 | if (tableSelected && tableColCount == model->columnCount(tableParent)
|
|---|
| 818 | && tableRowCount == model->rowCount(tableParent)) {
|
|---|
| 819 | ranges.clear();
|
|---|
| 820 | currentSelection.clear();
|
|---|
| 821 | int bottom = tableRowCount - 1;
|
|---|
| 822 | int right = tableColCount - 1;
|
|---|
| 823 | QModelIndex tl = model->index(0, 0, tableParent);
|
|---|
| 824 | QModelIndex br = model->index(bottom, right, tableParent);
|
|---|
| 825 | currentSelection << QItemSelectionRange(tl, br);
|
|---|
| 826 | tableParent = QModelIndex();
|
|---|
| 827 | tableSelected = false;
|
|---|
| 828 | return;
|
|---|
| 829 | }
|
|---|
| 830 |
|
|---|
| 831 | if (savedPersistentCurrentIndexes.isEmpty() && savedPersistentIndexes.isEmpty()) {
|
|---|
| 832 | // either the selection was actually empty, or we
|
|---|
| 833 | // didn't get the layoutAboutToBeChanged() signal
|
|---|
| 834 | return;
|
|---|
| 835 | }
|
|---|
| 836 | // clear the "old" selection
|
|---|
| 837 | ranges.clear();
|
|---|
| 838 | currentSelection.clear();
|
|---|
| 839 |
|
|---|
| 840 | // sort the "new" selection, as preparation for merging
|
|---|
| 841 | qStableSort(savedPersistentIndexes.begin(), savedPersistentIndexes.end());
|
|---|
| 842 | qStableSort(savedPersistentCurrentIndexes.begin(), savedPersistentCurrentIndexes.end());
|
|---|
| 843 |
|
|---|
| 844 | // update the selection by merging the individual indexes
|
|---|
| 845 | ranges = mergeIndexes(savedPersistentIndexes);
|
|---|
| 846 | currentSelection = mergeIndexes(savedPersistentCurrentIndexes);
|
|---|
| 847 |
|
|---|
| 848 | // release the persistent indexes
|
|---|
| 849 | savedPersistentIndexes.clear();
|
|---|
| 850 | savedPersistentCurrentIndexes.clear();
|
|---|
| 851 | }
|
|---|
| 852 |
|
|---|
| 853 | /*!
|
|---|
| 854 | \class QItemSelectionModel
|
|---|
| 855 |
|
|---|
| 856 | \brief The QItemSelectionModel class keeps track of a view's selected items.
|
|---|
| 857 |
|
|---|
| 858 | \ingroup model-view
|
|---|
| 859 |
|
|---|
| 860 | A QItemSelectionModel keeps track of the selected items in a view, or
|
|---|
| 861 | in several views onto the same model. It also keeps track of the
|
|---|
| 862 | currently selected item in a view.
|
|---|
| 863 |
|
|---|
| 864 | The QItemSelectionModel class is one of the \l{Model/View Classes}
|
|---|
| 865 | and is part of Qt's \l{Model/View Programming}{model/view framework}.
|
|---|
| 866 |
|
|---|
| 867 | The selected items are stored using ranges. Whenever you want to
|
|---|
| 868 | modify the selected items use select() and provide either a
|
|---|
| 869 | QItemSelection, or a QModelIndex and a QItemSelectionModel::SelectionFlag.
|
|---|
| 870 |
|
|---|
| 871 | The QItemSelectionModel takes a two layer approach to selection
|
|---|
| 872 | management, dealing with both selected items that have been committed
|
|---|
| 873 | and items that are part of the current selection. The current
|
|---|
| 874 | selected items are part of the current interactive selection (for
|
|---|
| 875 | example with rubber-band selection or keyboard-shift selections).
|
|---|
| 876 |
|
|---|
| 877 | To update the currently selected items, use the bitwise OR of
|
|---|
| 878 | QItemSelectionModel::Current and any of the other SelectionFlags.
|
|---|
| 879 | If you omit the QItemSelectionModel::Current command, a new current
|
|---|
| 880 | selection will be created, and the previous one added to the whole
|
|---|
| 881 | selection. All functions operate on both layers; for example,
|
|---|
| 882 | selectedItems() will return items from both layers.
|
|---|
| 883 |
|
|---|
| 884 | \sa {Model/View Programming}, QAbstractItemModel, {Chart Example}
|
|---|
| 885 | */
|
|---|
| 886 |
|
|---|
| 887 | /*!
|
|---|
| 888 | Constructs a selection model that operates on the specified item \a model.
|
|---|
| 889 | */
|
|---|
| 890 | QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model)
|
|---|
| 891 | : QObject(*new QItemSelectionModelPrivate, model)
|
|---|
| 892 | {
|
|---|
| 893 | d_func()->model = model;
|
|---|
| 894 | if (model) {
|
|---|
| 895 | connect(model, SIGNAL(rowsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 896 | this, SLOT(_q_rowsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 897 | connect(model, SIGNAL(columnsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 898 | this, SLOT(_q_columnsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 899 | connect(model, SIGNAL(rowsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 900 | this, SLOT(_q_rowsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 901 | connect(model, SIGNAL(columnsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 902 | this, SLOT(_q_columnsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 903 | connect(model, SIGNAL(layoutAboutToBeChanged()),
|
|---|
| 904 | this, SLOT(_q_layoutAboutToBeChanged()));
|
|---|
| 905 | connect(model, SIGNAL(layoutChanged()),
|
|---|
| 906 | this, SLOT(_q_layoutChanged()));
|
|---|
| 907 | }
|
|---|
| 908 | }
|
|---|
| 909 |
|
|---|
| 910 | /*!
|
|---|
| 911 | Constructs a selection model that operates on the specified item \a model with \a parent.
|
|---|
| 912 | */
|
|---|
| 913 | QItemSelectionModel::QItemSelectionModel(QAbstractItemModel *model, QObject *parent)
|
|---|
| 914 | : QObject(*new QItemSelectionModelPrivate, parent)
|
|---|
| 915 | {
|
|---|
| 916 | d_func()->model = model;
|
|---|
| 917 | if (model) {
|
|---|
| 918 | connect(model, SIGNAL(rowsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 919 | this, SLOT(_q_rowsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 920 | connect(model, SIGNAL(columnsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 921 | this, SLOT(_q_columnsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 922 | connect(model, SIGNAL(rowsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 923 | this, SLOT(_q_rowsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 924 | connect(model, SIGNAL(columnsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 925 | this, SLOT(_q_columnsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 926 | connect(model, SIGNAL(layoutAboutToBeChanged()),
|
|---|
| 927 | this, SLOT(_q_layoutAboutToBeChanged()));
|
|---|
| 928 | connect(model, SIGNAL(layoutChanged()),
|
|---|
| 929 | this, SLOT(_q_layoutChanged()));
|
|---|
| 930 | }
|
|---|
| 931 | }
|
|---|
| 932 |
|
|---|
| 933 | /*!
|
|---|
| 934 | \internal
|
|---|
| 935 | */
|
|---|
| 936 | QItemSelectionModel::QItemSelectionModel(QItemSelectionModelPrivate &dd, QAbstractItemModel *model)
|
|---|
| 937 | : QObject(dd, model)
|
|---|
| 938 | {
|
|---|
| 939 | d_func()->model = model;
|
|---|
| 940 | if (model) {
|
|---|
| 941 | connect(model, SIGNAL(rowsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 942 | this, SLOT(_q_rowsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 943 | connect(model, SIGNAL(columnsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 944 | this, SLOT(_q_columnsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 945 | connect(model, SIGNAL(rowsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 946 | this, SLOT(_q_rowsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 947 | connect(model, SIGNAL(columnsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 948 | this, SLOT(_q_columnsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 949 | connect(model, SIGNAL(layoutAboutToBeChanged()),
|
|---|
| 950 | this, SLOT(_q_layoutAboutToBeChanged()));
|
|---|
| 951 | connect(model, SIGNAL(layoutChanged()),
|
|---|
| 952 | this, SLOT(_q_layoutChanged()));
|
|---|
| 953 | }
|
|---|
| 954 | }
|
|---|
| 955 |
|
|---|
| 956 | /*!
|
|---|
| 957 | Destroys the selection model.
|
|---|
| 958 | */
|
|---|
| 959 | QItemSelectionModel::~QItemSelectionModel()
|
|---|
| 960 | {
|
|---|
| 961 | Q_D(QItemSelectionModel);
|
|---|
| 962 | if (d->model) {
|
|---|
| 963 | disconnect(d->model, SIGNAL(rowsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 964 | this, SLOT(_q_rowsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 965 | disconnect(d->model, SIGNAL(columnsAboutToBeRemoved(QModelIndex,int,int)),
|
|---|
| 966 | this, SLOT(_q_columnsAboutToBeRemoved(QModelIndex,int,int)));
|
|---|
| 967 | disconnect(d->model, SIGNAL(rowsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 968 | this, SLOT(_q_rowsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 969 | disconnect(d->model, SIGNAL(columnsAboutToBeInserted(QModelIndex,int,int)),
|
|---|
| 970 | this, SLOT(_q_columnsAboutToBeInserted(QModelIndex,int,int)));
|
|---|
| 971 | disconnect(d->model, SIGNAL(layoutAboutToBeChanged()),
|
|---|
| 972 | this, SLOT(_q_layoutAboutToBeChanged()));
|
|---|
| 973 | disconnect(d->model, SIGNAL(layoutChanged()),
|
|---|
| 974 | this, SLOT(_q_layoutChanged()));
|
|---|
| 975 | }
|
|---|
| 976 | }
|
|---|
| 977 |
|
|---|
| 978 | /*!
|
|---|
| 979 | Selects the model item \a index using the specified \a command, and emits
|
|---|
| 980 | selectionChanged().
|
|---|
| 981 |
|
|---|
| 982 | \sa QItemSelectionModel::SelectionFlags
|
|---|
| 983 | */
|
|---|
| 984 | void QItemSelectionModel::select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)
|
|---|
| 985 | {
|
|---|
| 986 | QItemSelection selection(index, index);
|
|---|
| 987 | select(selection, command);
|
|---|
| 988 | }
|
|---|
| 989 |
|
|---|
| 990 | /*!
|
|---|
| 991 | \fn void QItemSelectionModel::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)
|
|---|
| 992 |
|
|---|
| 993 | This signal is emitted whenever the current item changes. The \a previous
|
|---|
| 994 | model item index is replaced by the \a current index as the selection's
|
|---|
| 995 | current item.
|
|---|
| 996 |
|
|---|
| 997 | Note that this signal will not be emitted when the item model is reset.
|
|---|
| 998 |
|
|---|
| 999 | \sa currentIndex() setCurrentIndex() selectionChanged()
|
|---|
| 1000 | */
|
|---|
| 1001 |
|
|---|
| 1002 | /*!
|
|---|
| 1003 | \fn void QItemSelectionModel::currentColumnChanged(const QModelIndex ¤t, const QModelIndex &previous)
|
|---|
| 1004 |
|
|---|
| 1005 | This signal is emitted if the \a current item changes and its column is
|
|---|
| 1006 | different to the column of the \a previous current item.
|
|---|
| 1007 |
|
|---|
| 1008 | Note that this signal will not be emitted when the item model is reset.
|
|---|
| 1009 |
|
|---|
| 1010 | \sa currentChanged() currentRowChanged() currentIndex() setCurrentIndex()
|
|---|
| 1011 | */
|
|---|
| 1012 |
|
|---|
| 1013 | /*!
|
|---|
| 1014 | \fn void QItemSelectionModel::currentRowChanged(const QModelIndex ¤t, const QModelIndex &previous)
|
|---|
| 1015 |
|
|---|
| 1016 | This signal is emitted if the \a current item changes and its row is
|
|---|
| 1017 | different to the row of the \a previous current item.
|
|---|
| 1018 |
|
|---|
| 1019 | Note that this signal will not be emitted when the item model is reset.
|
|---|
| 1020 |
|
|---|
| 1021 | \sa currentChanged() currentColumnChanged() currentIndex() setCurrentIndex()
|
|---|
| 1022 | */
|
|---|
| 1023 |
|
|---|
| 1024 | /*!
|
|---|
| 1025 | \fn void QItemSelectionModel::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)
|
|---|
| 1026 |
|
|---|
| 1027 | This signal is emitted whenever the selection changes. The change in the
|
|---|
| 1028 | selection is represented as an item selection of \a deselected items and
|
|---|
| 1029 | an item selection of \a selected items.
|
|---|
| 1030 |
|
|---|
| 1031 | Note the that the current index changes independently from the selection.
|
|---|
| 1032 | Also note that this signal will not be emitted when the item model is reset.
|
|---|
| 1033 |
|
|---|
| 1034 | \sa select() currentChanged()
|
|---|
| 1035 | */
|
|---|
| 1036 |
|
|---|
| 1037 | /*!
|
|---|
| 1038 | \enum QItemSelectionModel::SelectionFlag
|
|---|
| 1039 |
|
|---|
| 1040 | This enum describes the way the selection model will be updated.
|
|---|
| 1041 |
|
|---|
| 1042 | \value NoUpdate No selection will be made.
|
|---|
| 1043 | \value Clear The complete selection will be cleared.
|
|---|
| 1044 | \value Select All specified indexes will be selected.
|
|---|
| 1045 | \value Deselect All specified indexes will be deselected.
|
|---|
| 1046 | \value Toggle All specified indexes will be selected or
|
|---|
| 1047 | deselected depending on their current state.
|
|---|
| 1048 | \value Current The current selection will be updated.
|
|---|
| 1049 | \value Rows All indexes will be expanded to span rows.
|
|---|
| 1050 | \value Columns All indexes will be expanded to span columns.
|
|---|
| 1051 | \value SelectCurrent A combination of Select and Current, provided for
|
|---|
| 1052 | convenience.
|
|---|
| 1053 | \value ToggleCurrent A combination of Toggle and Current, provided for
|
|---|
| 1054 | convenience.
|
|---|
| 1055 | \value ClearAndSelect A combination of Clear and Select, provided for
|
|---|
| 1056 | convenience.
|
|---|
| 1057 | */
|
|---|
| 1058 |
|
|---|
| 1059 | /*!
|
|---|
| 1060 | Selects the item \a selection using the specified \a command, and emits
|
|---|
| 1061 | selectionChanged().
|
|---|
| 1062 |
|
|---|
| 1063 | \sa QItemSelectionModel::SelectionFlag
|
|---|
| 1064 | */
|
|---|
| 1065 | void QItemSelectionModel::select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)
|
|---|
| 1066 | {
|
|---|
| 1067 | Q_D(QItemSelectionModel);
|
|---|
| 1068 | if (command == NoUpdate)
|
|---|
| 1069 | return;
|
|---|
| 1070 |
|
|---|
| 1071 | // store old selection
|
|---|
| 1072 | QItemSelection sel = selection;
|
|---|
| 1073 | QItemSelection old = d->ranges;
|
|---|
| 1074 | old.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1075 |
|
|---|
| 1076 | // expand selection according to SelectionBehavior
|
|---|
| 1077 | if (command & Rows || command & Columns)
|
|---|
| 1078 | sel = d->expandSelection(sel, command);
|
|---|
| 1079 |
|
|---|
| 1080 | // clear ranges and currentSelection
|
|---|
| 1081 | if (command & Clear) {
|
|---|
| 1082 | d->ranges.clear();
|
|---|
| 1083 | d->currentSelection.clear();
|
|---|
| 1084 | }
|
|---|
| 1085 |
|
|---|
| 1086 | // merge and clear currentSelection if Current was not set (ie. start new currentSelection)
|
|---|
| 1087 | if (!(command & Current))
|
|---|
| 1088 | d->finalize();
|
|---|
| 1089 |
|
|---|
| 1090 | // update currentSelection
|
|---|
| 1091 | if (command & Toggle || command & Select || command & Deselect) {
|
|---|
| 1092 | d->currentCommand = command;
|
|---|
| 1093 | d->currentSelection = sel;
|
|---|
| 1094 | }
|
|---|
| 1095 |
|
|---|
| 1096 | // generate new selection, compare with old and emit selectionChanged()
|
|---|
| 1097 | QItemSelection newSelection = d->ranges;
|
|---|
| 1098 | newSelection.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1099 | emitSelectionChanged(newSelection, old);
|
|---|
| 1100 | }
|
|---|
| 1101 |
|
|---|
| 1102 | /*!
|
|---|
| 1103 | Clears the selection model. Emits selectionChanged() and currentChanged().
|
|---|
| 1104 | */
|
|---|
| 1105 | void QItemSelectionModel::clear()
|
|---|
| 1106 | {
|
|---|
| 1107 | Q_D(QItemSelectionModel);
|
|---|
| 1108 | clearSelection();
|
|---|
| 1109 | QModelIndex previous = d->currentIndex;
|
|---|
| 1110 | d->currentIndex = QModelIndex();
|
|---|
| 1111 | if (previous.isValid()) {
|
|---|
| 1112 | emit currentChanged(d->currentIndex, previous);
|
|---|
| 1113 | emit currentRowChanged(d->currentIndex, previous);
|
|---|
| 1114 | emit currentColumnChanged(d->currentIndex, previous);
|
|---|
| 1115 | }
|
|---|
| 1116 | }
|
|---|
| 1117 |
|
|---|
| 1118 | /*!
|
|---|
| 1119 | Clears the selection model. Does not emit any signals.
|
|---|
| 1120 | */
|
|---|
| 1121 | void QItemSelectionModel::reset()
|
|---|
| 1122 | {
|
|---|
| 1123 | bool block = blockSignals(true);
|
|---|
| 1124 | clear();
|
|---|
| 1125 | blockSignals(block);
|
|---|
| 1126 | }
|
|---|
| 1127 |
|
|---|
| 1128 | /*!
|
|---|
| 1129 | \since 4.2
|
|---|
| 1130 | Clears the selection in the selection model. Emits selectionChanged().
|
|---|
| 1131 | */
|
|---|
| 1132 | void QItemSelectionModel::clearSelection()
|
|---|
| 1133 | {
|
|---|
| 1134 | Q_D(QItemSelectionModel);
|
|---|
| 1135 | if (d->ranges.count() == 0 && d->currentSelection.count() == 0)
|
|---|
| 1136 | return;
|
|---|
| 1137 | QItemSelection selection = d->ranges;
|
|---|
| 1138 | selection.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1139 | d->ranges.clear();
|
|---|
| 1140 | d->currentSelection.clear();
|
|---|
| 1141 | emit selectionChanged(QItemSelection(), selection);
|
|---|
| 1142 | }
|
|---|
| 1143 |
|
|---|
| 1144 |
|
|---|
| 1145 | /*!
|
|---|
| 1146 | Sets the model item \a index to be the current item, and emits
|
|---|
| 1147 | currentChanged(). The current item is used for keyboard navigation and
|
|---|
| 1148 | focus indication; it is independent of any selected items, although a
|
|---|
| 1149 | selected item can also be the current item.
|
|---|
| 1150 |
|
|---|
| 1151 | Depending on the specified \a command, the \a index can also become part
|
|---|
| 1152 | of the current selection.
|
|---|
| 1153 | \sa select()
|
|---|
| 1154 | */
|
|---|
| 1155 | void QItemSelectionModel::setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)
|
|---|
| 1156 | {
|
|---|
| 1157 | Q_D(QItemSelectionModel);
|
|---|
| 1158 | if (index == d->currentIndex) {
|
|---|
| 1159 | if (command != NoUpdate)
|
|---|
| 1160 | select(index, command); // select item
|
|---|
| 1161 | return;
|
|---|
| 1162 | }
|
|---|
| 1163 | QPersistentModelIndex previous = d->currentIndex;
|
|---|
| 1164 | d->currentIndex = index; // set current before emitting selection changed below
|
|---|
| 1165 | if (command != NoUpdate)
|
|---|
| 1166 | select(d->currentIndex, command); // select item
|
|---|
| 1167 | emit currentChanged(d->currentIndex, previous);
|
|---|
| 1168 | if (d->currentIndex.row() != previous.row() ||
|
|---|
| 1169 | d->currentIndex.parent() != previous.parent())
|
|---|
| 1170 | emit currentRowChanged(d->currentIndex, previous);
|
|---|
| 1171 | if (d->currentIndex.column() != previous.column() ||
|
|---|
| 1172 | d->currentIndex.parent() != previous.parent())
|
|---|
| 1173 | emit currentColumnChanged(d->currentIndex, previous);
|
|---|
| 1174 | }
|
|---|
| 1175 |
|
|---|
| 1176 | /*!
|
|---|
| 1177 | Returns the model item index for the current item, or an invalid index
|
|---|
| 1178 | if there is no current item.
|
|---|
| 1179 | */
|
|---|
| 1180 | QModelIndex QItemSelectionModel::currentIndex() const
|
|---|
| 1181 | {
|
|---|
| 1182 | return static_cast<QModelIndex>(d_func()->currentIndex);
|
|---|
| 1183 | }
|
|---|
| 1184 |
|
|---|
| 1185 | /*!
|
|---|
| 1186 | Returns true if the given model item \a index is selected.
|
|---|
| 1187 | */
|
|---|
| 1188 | bool QItemSelectionModel::isSelected(const QModelIndex &index) const
|
|---|
| 1189 | {
|
|---|
| 1190 | Q_D(const QItemSelectionModel);
|
|---|
| 1191 | if (d->model != index.model() || !index.isValid())
|
|---|
| 1192 | return false;
|
|---|
| 1193 |
|
|---|
| 1194 | bool selected = false;
|
|---|
| 1195 | // search model ranges
|
|---|
| 1196 | QList<QItemSelectionRange>::const_iterator it = d->ranges.begin();
|
|---|
| 1197 | for (; it != d->ranges.end(); ++it) {
|
|---|
| 1198 | if ((*it).isValid() && (*it).contains(index)) {
|
|---|
| 1199 | selected = true;
|
|---|
| 1200 | break;
|
|---|
| 1201 | }
|
|---|
| 1202 | }
|
|---|
| 1203 |
|
|---|
| 1204 | // check currentSelection
|
|---|
| 1205 | if (d->currentSelection.count()) {
|
|---|
| 1206 | if ((d->currentCommand & Deselect) && selected)
|
|---|
| 1207 | selected = !d->currentSelection.contains(index);
|
|---|
| 1208 | else if (d->currentCommand & Toggle)
|
|---|
| 1209 | selected ^= d->currentSelection.contains(index);
|
|---|
| 1210 | else if ((d->currentCommand & Select) && !selected)
|
|---|
| 1211 | selected = d->currentSelection.contains(index);
|
|---|
| 1212 | }
|
|---|
| 1213 |
|
|---|
| 1214 | if (selected) {
|
|---|
| 1215 | Qt::ItemFlags flags = d->model->flags(index);
|
|---|
| 1216 | return (flags & Qt::ItemIsSelectable);
|
|---|
| 1217 | }
|
|---|
| 1218 |
|
|---|
| 1219 | return false;
|
|---|
| 1220 | }
|
|---|
| 1221 |
|
|---|
| 1222 | /*!
|
|---|
| 1223 | Returns true if all items are selected in the \a row with the given
|
|---|
| 1224 | \a parent.
|
|---|
| 1225 |
|
|---|
| 1226 | Note that this function is usually faster than calling isSelected()
|
|---|
| 1227 | on all items in the same row and that unselectable items are
|
|---|
| 1228 | ignored.
|
|---|
| 1229 | */
|
|---|
| 1230 | bool QItemSelectionModel::isRowSelected(int row, const QModelIndex &parent) const
|
|---|
| 1231 | {
|
|---|
| 1232 | Q_D(const QItemSelectionModel);
|
|---|
| 1233 | if (parent.isValid() && d->model != parent.model())
|
|---|
| 1234 | return false;
|
|---|
| 1235 |
|
|---|
| 1236 | // return false if row exist in currentSelection (Deselect)
|
|---|
| 1237 | if (d->currentCommand & Deselect && d->currentSelection.count()) {
|
|---|
| 1238 | for (int i=0; i<d->currentSelection.count(); ++i) {
|
|---|
| 1239 | if (d->currentSelection.at(i).parent() == parent &&
|
|---|
| 1240 | row >= d->currentSelection.at(i).top() &&
|
|---|
| 1241 | row <= d->currentSelection.at(i).bottom())
|
|---|
| 1242 | return false;
|
|---|
| 1243 | }
|
|---|
| 1244 | }
|
|---|
| 1245 | // return false if ranges in both currentSelection and ranges
|
|---|
| 1246 | // intersect and have the same row contained
|
|---|
| 1247 | if (d->currentCommand & Toggle && d->currentSelection.count()) {
|
|---|
| 1248 | for (int i=0; i<d->currentSelection.count(); ++i)
|
|---|
| 1249 | if (d->currentSelection.at(i).top() <= row &&
|
|---|
| 1250 | d->currentSelection.at(i).bottom() >= row)
|
|---|
| 1251 | for (int j=0; j<d->ranges.count(); ++j)
|
|---|
| 1252 | if (d->ranges.at(j).top() <= row && d->ranges.at(j).bottom() >= row
|
|---|
| 1253 | && d->currentSelection.at(i).intersected(d->ranges.at(j)).isValid())
|
|---|
| 1254 | return false;
|
|---|
| 1255 | }
|
|---|
| 1256 | // add ranges and currentSelection and check through them all
|
|---|
| 1257 | QList<QItemSelectionRange>::const_iterator it;
|
|---|
| 1258 | QList<QItemSelectionRange> joined = d->ranges;
|
|---|
| 1259 | if (d->currentSelection.count())
|
|---|
| 1260 | joined += d->currentSelection;
|
|---|
| 1261 | int colCount = d->model->columnCount(parent);
|
|---|
| 1262 | for (int column = 0; column < colCount; ++column) {
|
|---|
| 1263 | for (it = joined.constBegin(); it != joined.constEnd(); ++it) {
|
|---|
| 1264 | if ((*it).contains(row, column, parent)) {
|
|---|
| 1265 | bool selectable = false;
|
|---|
| 1266 | for (int i = column; !selectable && i <= (*it).right(); ++i) {
|
|---|
| 1267 | Qt::ItemFlags flags = d->model->index(row, i, parent).flags();
|
|---|
| 1268 | selectable = flags & Qt::ItemIsSelectable;
|
|---|
| 1269 | }
|
|---|
| 1270 | if (selectable){
|
|---|
| 1271 | column = qMax(column, (*it).right());
|
|---|
| 1272 | break;
|
|---|
| 1273 | }
|
|---|
| 1274 | }
|
|---|
| 1275 | }
|
|---|
| 1276 | if (it == joined.constEnd())
|
|---|
| 1277 | return false;
|
|---|
| 1278 | }
|
|---|
| 1279 | return colCount > 0; // no columns means no selected items
|
|---|
| 1280 | }
|
|---|
| 1281 |
|
|---|
| 1282 | /*!
|
|---|
| 1283 | Returns true if all items are selected in the \a column with the given
|
|---|
| 1284 | \a parent.
|
|---|
| 1285 |
|
|---|
| 1286 | Note that this function is usually faster than calling isSelected()
|
|---|
| 1287 | on all items in the same column and that unselectable items are
|
|---|
| 1288 | ignored.
|
|---|
| 1289 | */
|
|---|
| 1290 | bool QItemSelectionModel::isColumnSelected(int column, const QModelIndex &parent) const
|
|---|
| 1291 | {
|
|---|
| 1292 | Q_D(const QItemSelectionModel);
|
|---|
| 1293 | if (parent.isValid() && d->model != parent.model())
|
|---|
| 1294 | return false;
|
|---|
| 1295 |
|
|---|
| 1296 | // return false if column exist in currentSelection (Deselect)
|
|---|
| 1297 | if (d->currentCommand & Deselect && d->currentSelection.count()) {
|
|---|
| 1298 | for (int i = 0; i < d->currentSelection.count(); ++i) {
|
|---|
| 1299 | if (d->currentSelection.at(i).parent() == parent &&
|
|---|
| 1300 | column >= d->currentSelection.at(i).left() &&
|
|---|
| 1301 | column <= d->currentSelection.at(i).right())
|
|---|
| 1302 | return false;
|
|---|
| 1303 | }
|
|---|
| 1304 | }
|
|---|
| 1305 | // return false if ranges in both currentSelection and the selection model
|
|---|
| 1306 | // intersect and have the same column contained
|
|---|
| 1307 | if (d->currentCommand & Toggle && d->currentSelection.count()) {
|
|---|
| 1308 | for (int i = 0; i < d->currentSelection.count(); ++i) {
|
|---|
| 1309 | if (d->currentSelection.at(i).left() <= column &&
|
|---|
| 1310 | d->currentSelection.at(i).right() >= column) {
|
|---|
| 1311 | for (int j = 0; j < d->ranges.count(); ++j) {
|
|---|
| 1312 | if (d->ranges.at(j).left() <= column && d->ranges.at(j).right() >= column
|
|---|
| 1313 | && d->currentSelection.at(i).intersected(d->ranges.at(j)).isValid()) {
|
|---|
| 1314 | return false;
|
|---|
| 1315 | }
|
|---|
| 1316 | }
|
|---|
| 1317 | }
|
|---|
| 1318 | }
|
|---|
| 1319 | }
|
|---|
| 1320 | // add ranges and currentSelection and check through them all
|
|---|
| 1321 | QList<QItemSelectionRange>::const_iterator it;
|
|---|
| 1322 | QList<QItemSelectionRange> joined = d->ranges;
|
|---|
| 1323 | if (d->currentSelection.count())
|
|---|
| 1324 | joined += d->currentSelection;
|
|---|
| 1325 | int rowCount = d->model->rowCount(parent);
|
|---|
| 1326 | for (int row = 0; row < rowCount; ++row) {
|
|---|
| 1327 | for (it = joined.constBegin(); it != joined.constEnd(); ++it) {
|
|---|
| 1328 | if ((*it).contains(row, column, parent)) {
|
|---|
| 1329 | Qt::ItemFlags flags = d->model->index(row, column, parent).flags();
|
|---|
| 1330 | if ((flags & Qt::ItemIsSelectable) && (flags & Qt::ItemIsEnabled)) {
|
|---|
| 1331 | row = qMax(row, (*it).bottom());
|
|---|
| 1332 | break;
|
|---|
| 1333 | }
|
|---|
| 1334 | }
|
|---|
| 1335 | }
|
|---|
| 1336 | if (it == joined.constEnd())
|
|---|
| 1337 | return false;
|
|---|
| 1338 | }
|
|---|
| 1339 | return rowCount > 0; // no rows means no selected items
|
|---|
| 1340 | }
|
|---|
| 1341 |
|
|---|
| 1342 | /*!
|
|---|
| 1343 | Returns true if there are any items selected in the \a row with the given
|
|---|
| 1344 | \a parent.
|
|---|
| 1345 | */
|
|---|
| 1346 | bool QItemSelectionModel::rowIntersectsSelection(int row, const QModelIndex &parent) const
|
|---|
| 1347 | {
|
|---|
| 1348 | Q_D(const QItemSelectionModel);
|
|---|
| 1349 | if (parent.isValid() && d->model != parent.model())
|
|---|
| 1350 | return false;
|
|---|
| 1351 |
|
|---|
| 1352 | QItemSelection sel = d->ranges;
|
|---|
| 1353 | sel.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1354 | for (int i = 0; i < sel.count(); ++i) {
|
|---|
| 1355 | int top = sel.at(i).top();
|
|---|
| 1356 | int bottom = sel.at(i).bottom();
|
|---|
| 1357 | int left = sel.at(i).left();
|
|---|
| 1358 | int right = sel.at(i).right();
|
|---|
| 1359 | if (top <= row && bottom >= row) {
|
|---|
| 1360 | for (int j = left; j <= right; j++) {
|
|---|
| 1361 | const Qt::ItemFlags flags = d->model->index(row, j, parent).flags();
|
|---|
| 1362 | if ((flags & Qt::ItemIsSelectable) && (flags & Qt::ItemIsEnabled))
|
|---|
| 1363 | return true;
|
|---|
| 1364 | }
|
|---|
| 1365 | }
|
|---|
| 1366 | }
|
|---|
| 1367 |
|
|---|
| 1368 | return false;
|
|---|
| 1369 | }
|
|---|
| 1370 |
|
|---|
| 1371 | /*!
|
|---|
| 1372 | Returns true if there are any items selected in the \a column with the given
|
|---|
| 1373 | \a parent.
|
|---|
| 1374 | */
|
|---|
| 1375 | bool QItemSelectionModel::columnIntersectsSelection(int column, const QModelIndex &parent) const
|
|---|
| 1376 | {
|
|---|
| 1377 | Q_D(const QItemSelectionModel);
|
|---|
| 1378 | if (parent.isValid() && d->model != parent.model())
|
|---|
| 1379 | return false;
|
|---|
| 1380 |
|
|---|
| 1381 | QItemSelection sel = d->ranges;
|
|---|
| 1382 | sel.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1383 | for (int i = 0; i < sel.count(); ++i) {
|
|---|
| 1384 | int left = sel.at(i).left();
|
|---|
| 1385 | int right = sel.at(i).right();
|
|---|
| 1386 | int top = sel.at(i).top();
|
|---|
| 1387 | int bottom = sel.at(i).bottom();
|
|---|
| 1388 | if (left <= column && right >= column) {
|
|---|
| 1389 | for (int j = top; j <= bottom; j++) {
|
|---|
| 1390 | const Qt::ItemFlags flags = d->model->index(j, column, parent).flags();
|
|---|
| 1391 | if ((flags & Qt::ItemIsSelectable) && (flags & Qt::ItemIsEnabled))
|
|---|
| 1392 | return true;
|
|---|
| 1393 | }
|
|---|
| 1394 | }
|
|---|
| 1395 | }
|
|---|
| 1396 |
|
|---|
| 1397 | return false;
|
|---|
| 1398 | }
|
|---|
| 1399 |
|
|---|
| 1400 | /*!
|
|---|
| 1401 | \since 4.2
|
|---|
| 1402 |
|
|---|
| 1403 | Returns true if the selection model contains any selection ranges;
|
|---|
| 1404 | otherwise returns false.
|
|---|
| 1405 | */
|
|---|
| 1406 | bool QItemSelectionModel::hasSelection() const
|
|---|
| 1407 | {
|
|---|
| 1408 | Q_D(const QItemSelectionModel);
|
|---|
| 1409 | if (d->currentCommand & (Toggle | Deselect)) {
|
|---|
| 1410 | QItemSelection sel = d->ranges;
|
|---|
| 1411 | sel.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1412 | return !sel.isEmpty();
|
|---|
| 1413 | } else {
|
|---|
| 1414 | return !(d->ranges.isEmpty() && d->currentSelection.isEmpty());
|
|---|
| 1415 | }
|
|---|
| 1416 | }
|
|---|
| 1417 |
|
|---|
| 1418 | /*!
|
|---|
| 1419 | Returns a list of all selected model item indexes. The list contains no
|
|---|
| 1420 | duplicates, and is not sorted.
|
|---|
| 1421 | */
|
|---|
| 1422 | QModelIndexList QItemSelectionModel::selectedIndexes() const
|
|---|
| 1423 | {
|
|---|
| 1424 | Q_D(const QItemSelectionModel);
|
|---|
| 1425 | QItemSelection selected = d->ranges;
|
|---|
| 1426 | selected.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1427 | return selected.indexes();
|
|---|
| 1428 | }
|
|---|
| 1429 |
|
|---|
| 1430 | /*!
|
|---|
| 1431 | \since 4.2
|
|---|
| 1432 | Returns the indexes in the given \a column for the rows where all columns are selected.
|
|---|
| 1433 |
|
|---|
| 1434 | \sa selectedIndexes(), selectedColumns()
|
|---|
| 1435 | */
|
|---|
| 1436 |
|
|---|
| 1437 | QModelIndexList QItemSelectionModel::selectedRows(int column) const
|
|---|
| 1438 | {
|
|---|
| 1439 | QModelIndexList indexes;
|
|---|
| 1440 | //the QSet contains pairs of parent modelIndex
|
|---|
| 1441 | //and row number
|
|---|
| 1442 | QSet< QPair<QModelIndex, int> > rowsSeen;
|
|---|
| 1443 |
|
|---|
| 1444 | const QItemSelection ranges = selection();
|
|---|
| 1445 | for (int i = 0; i < ranges.count(); ++i) {
|
|---|
| 1446 | const QItemSelectionRange &range = ranges.at(i);
|
|---|
| 1447 | QModelIndex parent = range.parent();
|
|---|
| 1448 | for (int row = range.top(); row <= range.bottom(); row++) {
|
|---|
| 1449 | QPair<QModelIndex, int> rowDef = qMakePair(parent, row);
|
|---|
| 1450 | if (!rowsSeen.contains(rowDef)) {
|
|---|
| 1451 | rowsSeen << rowDef;
|
|---|
| 1452 | if (isRowSelected(row, parent)) {
|
|---|
| 1453 | indexes.append(model()->index(row, column, parent));
|
|---|
| 1454 | }
|
|---|
| 1455 | }
|
|---|
| 1456 | }
|
|---|
| 1457 | }
|
|---|
| 1458 |
|
|---|
| 1459 | return indexes;
|
|---|
| 1460 | }
|
|---|
| 1461 |
|
|---|
| 1462 | /*!
|
|---|
| 1463 | \since 4.2
|
|---|
| 1464 | Returns the indexes in the given \a row for columns where all rows are selected.
|
|---|
| 1465 |
|
|---|
| 1466 | \sa selectedIndexes(), selectedRows()
|
|---|
| 1467 | */
|
|---|
| 1468 |
|
|---|
| 1469 | QModelIndexList QItemSelectionModel::selectedColumns(int row) const
|
|---|
| 1470 | {
|
|---|
| 1471 | QModelIndexList indexes;
|
|---|
| 1472 | //the QSet contains pairs of parent modelIndex
|
|---|
| 1473 | //and column number
|
|---|
| 1474 | QSet< QPair<QModelIndex, int> > columnsSeen;
|
|---|
| 1475 |
|
|---|
| 1476 | const QItemSelection ranges = selection();
|
|---|
| 1477 | for (int i = 0; i < ranges.count(); ++i) {
|
|---|
| 1478 | const QItemSelectionRange &range = ranges.at(i);
|
|---|
| 1479 | QModelIndex parent = range.parent();
|
|---|
| 1480 | for (int column = range.left(); column <= range.right(); column++) {
|
|---|
| 1481 | QPair<QModelIndex, int> columnDef = qMakePair(parent, column);
|
|---|
| 1482 | if (!columnsSeen.contains(columnDef)) {
|
|---|
| 1483 | columnsSeen << columnDef;
|
|---|
| 1484 | if (isColumnSelected(column, parent)) {
|
|---|
| 1485 | indexes.append(model()->index(row, column, parent));
|
|---|
| 1486 | }
|
|---|
| 1487 | }
|
|---|
| 1488 | }
|
|---|
| 1489 | }
|
|---|
| 1490 |
|
|---|
| 1491 | return indexes;
|
|---|
| 1492 | }
|
|---|
| 1493 |
|
|---|
| 1494 | /*!
|
|---|
| 1495 | Returns the selection ranges stored in the selection model.
|
|---|
| 1496 | */
|
|---|
| 1497 | const QItemSelection QItemSelectionModel::selection() const
|
|---|
| 1498 | {
|
|---|
| 1499 | Q_D(const QItemSelectionModel);
|
|---|
| 1500 | QItemSelection selected = d->ranges;
|
|---|
| 1501 | selected.merge(d->currentSelection, d->currentCommand);
|
|---|
| 1502 | int i = 0;
|
|---|
| 1503 | // make sure we have no invalid ranges
|
|---|
| 1504 | // ### should probably be handled more generic somewhere else
|
|---|
| 1505 | while (i<selected.count()) {
|
|---|
| 1506 | if (selected.at(i).isValid())
|
|---|
| 1507 | ++i;
|
|---|
| 1508 | else
|
|---|
| 1509 | (selected.removeAt(i));
|
|---|
| 1510 | }
|
|---|
| 1511 | return selected;
|
|---|
| 1512 | }
|
|---|
| 1513 |
|
|---|
| 1514 | /*!
|
|---|
| 1515 | Returns the item model operated on by the selection model.
|
|---|
| 1516 | */
|
|---|
| 1517 | const QAbstractItemModel *QItemSelectionModel::model() const
|
|---|
| 1518 | {
|
|---|
| 1519 | return d_func()->model;
|
|---|
| 1520 | }
|
|---|
| 1521 |
|
|---|
| 1522 | /*!
|
|---|
| 1523 | Compares the two selections \a newSelection and \a oldSelection
|
|---|
| 1524 | and emits selectionChanged() with the deselected and selected items.
|
|---|
| 1525 | */
|
|---|
| 1526 | void QItemSelectionModel::emitSelectionChanged(const QItemSelection &newSelection,
|
|---|
| 1527 | const QItemSelection &oldSelection)
|
|---|
| 1528 | {
|
|---|
| 1529 | // if both selections are empty or equal we return
|
|---|
| 1530 | if ((oldSelection.isEmpty() && newSelection.isEmpty()) ||
|
|---|
| 1531 | oldSelection == newSelection)
|
|---|
| 1532 | return;
|
|---|
| 1533 |
|
|---|
| 1534 | // if either selection is empty we do not need to compare
|
|---|
| 1535 | if (oldSelection.isEmpty() || newSelection.isEmpty()) {
|
|---|
| 1536 | emit selectionChanged(newSelection, oldSelection);
|
|---|
| 1537 | return;
|
|---|
| 1538 | }
|
|---|
| 1539 |
|
|---|
| 1540 | QItemSelection deselected = oldSelection;
|
|---|
| 1541 | QItemSelection selected = newSelection;
|
|---|
| 1542 |
|
|---|
| 1543 | // remove equal ranges
|
|---|
| 1544 | bool advance;
|
|---|
| 1545 | for (int o = 0; o < deselected.count(); ++o) {
|
|---|
| 1546 | advance = true;
|
|---|
| 1547 | for (int s = 0; s < selected.count() && o < deselected.count();) {
|
|---|
| 1548 | if (deselected.at(o) == selected.at(s)) {
|
|---|
| 1549 | deselected.removeAt(o);
|
|---|
| 1550 | selected.removeAt(s);
|
|---|
| 1551 | advance = false;
|
|---|
| 1552 | } else {
|
|---|
| 1553 | ++s;
|
|---|
| 1554 | }
|
|---|
| 1555 | }
|
|---|
| 1556 | if (advance)
|
|---|
| 1557 | ++o;
|
|---|
| 1558 | }
|
|---|
| 1559 |
|
|---|
| 1560 | // find intersections
|
|---|
| 1561 | QItemSelection intersections;
|
|---|
| 1562 | for (int o = 0; o < deselected.count(); ++o) {
|
|---|
| 1563 | for (int s = 0; s < selected.count(); ++s) {
|
|---|
| 1564 | if (deselected.at(o).intersects(selected.at(s)))
|
|---|
| 1565 | intersections.append(deselected.at(o).intersected(selected.at(s)));
|
|---|
| 1566 | }
|
|---|
| 1567 | }
|
|---|
| 1568 |
|
|---|
| 1569 | // compare remaining ranges with intersections and split them to find deselected and selected
|
|---|
| 1570 | for (int i = 0; i < intersections.count(); ++i) {
|
|---|
| 1571 | // split deselected
|
|---|
| 1572 | for (int o = 0; o < deselected.count();) {
|
|---|
| 1573 | if (deselected.at(o).intersects(intersections.at(i))) {
|
|---|
| 1574 | QItemSelection::split(deselected.at(o), intersections.at(i), &deselected);
|
|---|
| 1575 | deselected.removeAt(o);
|
|---|
| 1576 | } else {
|
|---|
| 1577 | ++o;
|
|---|
| 1578 | }
|
|---|
| 1579 | }
|
|---|
| 1580 | // split selected
|
|---|
| 1581 | for (int s = 0; s < selected.count();) {
|
|---|
| 1582 | if (selected.at(s).intersects(intersections.at(i))) {
|
|---|
| 1583 | QItemSelection::split(selected.at(s), intersections.at(i), &selected);
|
|---|
| 1584 | selected.removeAt(s);
|
|---|
| 1585 | } else {
|
|---|
| 1586 | ++s;
|
|---|
| 1587 | }
|
|---|
| 1588 | }
|
|---|
| 1589 | }
|
|---|
| 1590 |
|
|---|
| 1591 | if (!selected.isEmpty() || !deselected.isEmpty())
|
|---|
| 1592 | emit selectionChanged(selected, deselected);
|
|---|
| 1593 | }
|
|---|
| 1594 |
|
|---|
| 1595 | #ifndef QT_NO_DEBUG_STREAM
|
|---|
| 1596 | QDebug operator<<(QDebug dbg, const QItemSelectionRange &range)
|
|---|
| 1597 | {
|
|---|
| 1598 | #ifndef Q_BROKEN_DEBUG_STREAM
|
|---|
| 1599 | dbg.nospace() << "QItemSelectionRange(" << range.topLeft()
|
|---|
| 1600 | << ',' << range.bottomRight() << ')';
|
|---|
| 1601 | return dbg.space();
|
|---|
| 1602 | #else
|
|---|
| 1603 | qWarning("This compiler doesn't support streaming QItemSelectionRange to QDebug");
|
|---|
| 1604 | return dbg;
|
|---|
| 1605 | Q_UNUSED(range);
|
|---|
| 1606 | #endif
|
|---|
| 1607 | }
|
|---|
| 1608 | #endif
|
|---|
| 1609 |
|
|---|
| 1610 | QT_END_NAMESPACE
|
|---|
| 1611 |
|
|---|
| 1612 | #include "moc_qitemselectionmodel.cpp"
|
|---|
| 1613 |
|
|---|
| 1614 | #endif // QT_NO_ITEMVIEWS
|
|---|