| 1 | /**************************************************************************** |
| 2 | ** |
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. |
| 4 | ** Copyright (C) 2020 Klarälvdalens Datakonsult AB, a KDAB Group company, info@kdab.com, author Giuseppe D'Angelo <giuseppe.dangelo@kdab.com> |
| 5 | ** Contact: https://www.qt.io/licensing/ |
| 6 | ** |
| 7 | ** This file is part of the QtCore module of the Qt Toolkit. |
| 8 | ** |
| 9 | ** $QT_BEGIN_LICENSE:LGPL$ |
| 10 | ** Commercial License Usage |
| 11 | ** Licensees holding valid commercial Qt licenses may use this file in |
| 12 | ** accordance with the commercial license agreement provided with the |
| 13 | ** Software or, alternatively, in accordance with the terms contained in |
| 14 | ** a written agreement between you and The Qt Company. For licensing terms |
| 15 | ** and conditions see https://www.qt.io/terms-conditions. For further |
| 16 | ** information use the contact form at https://www.qt.io/contact-us. |
| 17 | ** |
| 18 | ** GNU Lesser General Public License Usage |
| 19 | ** Alternatively, this file may be used under the terms of the GNU Lesser |
| 20 | ** General Public License version 3 as published by the Free Software |
| 21 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| 22 | ** packaging of this file. Please review the following information to |
| 23 | ** ensure the GNU Lesser General Public License version 3 requirements |
| 24 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| 25 | ** |
| 26 | ** GNU General Public License Usage |
| 27 | ** Alternatively, this file may be used under the terms of the GNU |
| 28 | ** General Public License version 2.0 or (at your option) the GNU General |
| 29 | ** Public license version 3 or any later version approved by the KDE Free |
| 30 | ** Qt Foundation. The licenses are as published by the Free Software |
| 31 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| 32 | ** included in the packaging of this file. Please review the following |
| 33 | ** information to ensure the GNU General Public License requirements will |
| 34 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| 35 | ** https://www.gnu.org/licenses/gpl-3.0.html. |
| 36 | ** |
| 37 | ** $QT_END_LICENSE$ |
| 38 | ** |
| 39 | ****************************************************************************/ |
| 40 | |
| 41 | #ifndef QABSTRACTITEMMODEL_H |
| 42 | #define QABSTRACTITEMMODEL_H |
| 43 | |
| 44 | #include <QtCore/qhash.h> |
| 45 | #include <QtCore/qlist.h> |
| 46 | #include <QtCore/qobject.h> |
| 47 | #include <QtCore/qvariant.h> |
| 48 | |
| 49 | QT_REQUIRE_CONFIG(itemmodel); |
| 50 | |
| 51 | QT_BEGIN_NAMESPACE |
| 52 | |
| 53 | class QModelRoleData |
| 54 | { |
| 55 | int m_role; |
| 56 | QVariant m_data; |
| 57 | |
| 58 | public: |
| 59 | explicit QModelRoleData(int role) noexcept |
| 60 | : m_role(role) |
| 61 | {} |
| 62 | |
| 63 | constexpr int role() const noexcept { return m_role; } |
| 64 | constexpr QVariant &data() noexcept { return m_data; } |
| 65 | constexpr const QVariant &data() const noexcept { return m_data; } |
| 66 | |
| 67 | template <typename T> |
| 68 | constexpr void setData(T &&value) noexcept(noexcept(m_data.setValue(std::forward<T>(value)))) |
| 69 | { m_data.setValue(std::forward<T>(value)); } |
| 70 | |
| 71 | void clearData() noexcept { m_data.clear(); } |
| 72 | }; |
| 73 | |
| 74 | Q_DECLARE_TYPEINFO(QModelRoleData, Q_MOVABLE_TYPE); |
| 75 | |
| 76 | class QModelRoleDataSpan; |
| 77 | |
| 78 | namespace QtPrivate { |
| 79 | template <typename T, typename Enable = void> |
| 80 | struct IsContainerCompatibleWithModelRoleDataSpan : std::false_type {}; |
| 81 | |
| 82 | template <typename T> |
| 83 | struct IsContainerCompatibleWithModelRoleDataSpan<T, std::enable_if_t<std::conjunction_v< |
| 84 | // lacking concepts and ranges, we accept any T whose std::data yields a suitable pointer ... |
| 85 | std::is_convertible<decltype( std::data(std::declval<T &>()) ), QModelRoleData *>, |
| 86 | // ... and that has a suitable size ... |
| 87 | std::is_convertible<decltype( std::size(std::declval<T &>()) ), qsizetype>, |
| 88 | // ... and it's a range as it defines an iterator-like API |
| 89 | std::is_convertible< |
| 90 | typename std::iterator_traits<decltype( std::begin(std::declval<T &>()) )>::value_type, |
| 91 | QModelRoleData |
| 92 | >, |
| 93 | std::is_convertible< |
| 94 | decltype( std::begin(std::declval<T &>()) != std::end(std::declval<T &>()) ), |
| 95 | bool>, |
| 96 | // Don't make an accidental copy constructor |
| 97 | std::negation<std::is_same<std::decay_t<T>, QModelRoleDataSpan>> |
| 98 | >>> : std::true_type {}; |
| 99 | } // namespace QtPrivate |
| 100 | |
| 101 | class QModelRoleDataSpan |
| 102 | { |
| 103 | QModelRoleData *m_modelRoleData = nullptr; |
| 104 | qsizetype m_len = 0; |
| 105 | |
| 106 | template <typename T> |
| 107 | using if_compatible_container = std::enable_if_t<QtPrivate::IsContainerCompatibleWithModelRoleDataSpan<T>::value, bool>; |
| 108 | |
| 109 | public: |
| 110 | constexpr QModelRoleDataSpan() noexcept {} |
| 111 | |
| 112 | constexpr QModelRoleDataSpan(QModelRoleData &modelRoleData) noexcept |
| 113 | : m_modelRoleData(&modelRoleData), |
| 114 | m_len(1) |
| 115 | {} |
| 116 | |
| 117 | constexpr QModelRoleDataSpan(QModelRoleData *modelRoleData, qsizetype len) |
| 118 | : m_modelRoleData(modelRoleData), |
| 119 | m_len(len) |
| 120 | {} |
| 121 | |
| 122 | template <typename Container, if_compatible_container<Container> = true> |
| 123 | constexpr QModelRoleDataSpan(Container &c) noexcept(noexcept(std::data(c)) && noexcept(std::size(c))) |
| 124 | : m_modelRoleData(std::data(c)), |
| 125 | m_len(qsizetype(std::size(c))) |
| 126 | {} |
| 127 | |
| 128 | constexpr qsizetype size() const noexcept { return m_len; } |
| 129 | constexpr qsizetype length() const noexcept { return m_len; } |
| 130 | constexpr QModelRoleData *data() const noexcept { return m_modelRoleData; } |
| 131 | constexpr QModelRoleData *begin() const noexcept { return m_modelRoleData; } |
| 132 | constexpr QModelRoleData *end() const noexcept { return m_modelRoleData + m_len; } |
| 133 | constexpr QModelRoleData &operator[](qsizetype index) const { return m_modelRoleData[index]; } |
| 134 | |
| 135 | constexpr QVariant *dataForRole(int role) const |
| 136 | { |
| 137 | #ifdef __cpp_lib_constexpr_algorithms |
| 138 | auto result = std::find_if(begin(), end(), [role](const QModelRoleData &roleData) { |
| 139 | return roleData.role() == role; |
| 140 | }); |
| 141 | #else |
| 142 | auto result = begin(); |
| 143 | const auto e = end(); |
| 144 | for (; result != e; ++result) { |
| 145 | if (result->role() == role) |
| 146 | break; |
| 147 | } |
| 148 | #endif |
| 149 | |
| 150 | return Q_ASSERT(result != end()), &result->data(); |
| 151 | } |
| 152 | }; |
| 153 | |
| 154 | Q_DECLARE_TYPEINFO(QModelRoleDataSpan, Q_MOVABLE_TYPE); |
| 155 | |
| 156 | class QAbstractItemModel; |
| 157 | class QPersistentModelIndex; |
| 158 | |
| 159 | class QModelIndex |
| 160 | { |
| 161 | friend class QAbstractItemModel; |
| 162 | public: |
| 163 | constexpr inline QModelIndex() noexcept : r(-1), c(-1), i(0), m(nullptr) {} |
| 164 | // compiler-generated copy/move ctors/assignment operators are fine! |
| 165 | constexpr inline int row() const noexcept { return r; } |
| 166 | constexpr inline int column() const noexcept { return c; } |
| 167 | constexpr inline quintptr internalId() const noexcept { return i; } |
| 168 | inline void *internalPointer() const noexcept { return reinterpret_cast<void*>(i); } |
| 169 | inline const void *constInternalPointer() const noexcept { return reinterpret_cast<const void *>(i); } |
| 170 | inline QModelIndex parent() const; |
| 171 | inline QModelIndex sibling(int row, int column) const; |
| 172 | inline QModelIndex siblingAtColumn(int column) const; |
| 173 | inline QModelIndex siblingAtRow(int row) const; |
| 174 | inline QVariant data(int role = Qt::DisplayRole) const; |
| 175 | inline void multiData(QModelRoleDataSpan roleDataSpan) const; |
| 176 | inline Qt::ItemFlags flags() const; |
| 177 | constexpr inline const QAbstractItemModel *model() const noexcept { return m; } |
| 178 | constexpr inline bool isValid() const noexcept { return (r >= 0) && (c >= 0) && (m != nullptr); } |
| 179 | constexpr inline bool operator==(const QModelIndex &other) const noexcept |
| 180 | { return (other.r == r) && (other.i == i) && (other.c == c) && (other.m == m); } |
| 181 | constexpr inline bool operator!=(const QModelIndex &other) const noexcept |
| 182 | { return !(*this == other); } |
| 183 | constexpr inline bool operator<(const QModelIndex &other) const noexcept |
| 184 | { |
| 185 | return r < other.r |
| 186 | || (r == other.r && (c < other.c |
| 187 | || (c == other.c && (i < other.i |
| 188 | || (i == other.i && std::less<const QAbstractItemModel *>()(m, other.m)))))); |
| 189 | } |
| 190 | private: |
| 191 | inline QModelIndex(int arow, int acolumn, const void *ptr, const QAbstractItemModel *amodel) noexcept |
| 192 | : r(arow), c(acolumn), i(reinterpret_cast<quintptr>(ptr)), m(amodel) {} |
| 193 | constexpr inline QModelIndex(int arow, int acolumn, quintptr id, const QAbstractItemModel *amodel) noexcept |
| 194 | : r(arow), c(acolumn), i(id), m(amodel) {} |
| 195 | int r, c; |
| 196 | quintptr i; |
| 197 | const QAbstractItemModel *m; |
| 198 | }; |
| 199 | Q_DECLARE_TYPEINFO(QModelIndex, Q_MOVABLE_TYPE); |
| 200 | |
| 201 | #ifndef QT_NO_DEBUG_STREAM |
| 202 | Q_CORE_EXPORT QDebug operator<<(QDebug, const QModelIndex &); |
| 203 | #endif |
| 204 | |
| 205 | class QPersistentModelIndexData; |
| 206 | |
| 207 | // qHash is a friend, but we can't use default arguments for friends (§8.3.6.4) |
| 208 | size_t qHash(const QPersistentModelIndex &index, size_t seed = 0) noexcept; |
| 209 | |
| 210 | class Q_CORE_EXPORT QPersistentModelIndex |
| 211 | { |
| 212 | public: |
| 213 | QPersistentModelIndex(); |
| 214 | QPersistentModelIndex(const QModelIndex &index); |
| 215 | QPersistentModelIndex(const QPersistentModelIndex &other); |
| 216 | ~QPersistentModelIndex(); |
| 217 | bool operator<(const QPersistentModelIndex &other) const; |
| 218 | bool operator==(const QPersistentModelIndex &other) const; |
| 219 | inline bool operator!=(const QPersistentModelIndex &other) const |
| 220 | { return !operator==(other); } |
| 221 | QPersistentModelIndex &operator=(const QPersistentModelIndex &other); |
| 222 | inline QPersistentModelIndex(QPersistentModelIndex &&other) noexcept |
| 223 | : d(qExchange(other.d, nullptr)) {} |
| 224 | QT_MOVE_ASSIGNMENT_OPERATOR_IMPL_VIA_PURE_SWAP(QPersistentModelIndex) |
| 225 | inline void swap(QPersistentModelIndex &other) noexcept { qSwap(d, other.d); } |
| 226 | bool operator==(const QModelIndex &other) const; |
| 227 | bool operator!=(const QModelIndex &other) const; |
| 228 | QPersistentModelIndex &operator=(const QModelIndex &other); |
| 229 | operator const QModelIndex&() const; |
| 230 | int row() const; |
| 231 | int column() const; |
| 232 | void *internalPointer() const; |
| 233 | const void *constInternalPointer() const; |
| 234 | quintptr internalId() const; |
| 235 | QModelIndex parent() const; |
| 236 | QModelIndex sibling(int row, int column) const; |
| 237 | QVariant data(int role = Qt::DisplayRole) const; |
| 238 | void multiData(QModelRoleDataSpan roleDataSpan) const; |
| 239 | Qt::ItemFlags flags() const; |
| 240 | const QAbstractItemModel *model() const; |
| 241 | bool isValid() const; |
| 242 | private: |
| 243 | QPersistentModelIndexData *d; |
| 244 | friend size_t qHash(const QPersistentModelIndex &, size_t seed) noexcept; |
| 245 | #ifndef QT_NO_DEBUG_STREAM |
| 246 | friend Q_CORE_EXPORT QDebug operator<<(QDebug, const QPersistentModelIndex &); |
| 247 | #endif |
| 248 | }; |
| 249 | Q_DECLARE_SHARED(QPersistentModelIndex) |
| 250 | |
| 251 | inline size_t qHash(const QPersistentModelIndex &index, size_t seed) noexcept |
| 252 | { return qHash(index.d, seed); } |
| 253 | |
| 254 | |
| 255 | #ifndef QT_NO_DEBUG_STREAM |
| 256 | Q_CORE_EXPORT QDebug operator<<(QDebug, const QPersistentModelIndex &); |
| 257 | #endif |
| 258 | |
| 259 | typedef QList<QModelIndex> QModelIndexList; |
| 260 | |
| 261 | class QMimeData; |
| 262 | class QAbstractItemModelPrivate; |
| 263 | class QTransposeProxyModelPrivate; |
| 264 | template <class Key, class T> class QMap; |
| 265 | |
| 266 | |
| 267 | class Q_CORE_EXPORT QAbstractItemModel : public QObject |
| 268 | { |
| 269 | Q_OBJECT |
| 270 | |
| 271 | friend class QPersistentModelIndexData; |
| 272 | friend class QAbstractItemViewPrivate; |
| 273 | friend class QIdentityProxyModel; |
| 274 | friend class QTransposeProxyModelPrivate; |
| 275 | public: |
| 276 | |
| 277 | explicit QAbstractItemModel(QObject *parent = nullptr); |
| 278 | virtual ~QAbstractItemModel(); |
| 279 | |
| 280 | Q_INVOKABLE bool hasIndex(int row, int column, const QModelIndex &parent = QModelIndex()) const; |
| 281 | Q_INVOKABLE virtual QModelIndex index(int row, int column, |
| 282 | const QModelIndex &parent = QModelIndex()) const = 0; |
| 283 | Q_INVOKABLE virtual QModelIndex parent(const QModelIndex &child) const = 0; |
| 284 | |
| 285 | Q_INVOKABLE virtual QModelIndex sibling(int row, int column, const QModelIndex &idx) const; |
| 286 | Q_INVOKABLE virtual int rowCount(const QModelIndex &parent = QModelIndex()) const = 0; |
| 287 | Q_INVOKABLE virtual int columnCount(const QModelIndex &parent = QModelIndex()) const = 0; |
| 288 | Q_INVOKABLE virtual bool hasChildren(const QModelIndex &parent = QModelIndex()) const; |
| 289 | |
| 290 | Q_INVOKABLE virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const = 0; |
| 291 | Q_INVOKABLE virtual bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole); |
| 292 | |
| 293 | Q_INVOKABLE virtual QVariant (int section, Qt::Orientation orientation, |
| 294 | int role = Qt::DisplayRole) const; |
| 295 | virtual bool (int section, Qt::Orientation orientation, const QVariant &value, |
| 296 | int role = Qt::EditRole); |
| 297 | |
| 298 | virtual QMap<int, QVariant> itemData(const QModelIndex &index) const; |
| 299 | virtual bool setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles); |
| 300 | virtual bool clearItemData(const QModelIndex &index); |
| 301 | |
| 302 | virtual QStringList mimeTypes() const; |
| 303 | virtual QMimeData *mimeData(const QModelIndexList &indexes) const; |
| 304 | virtual bool canDropMimeData(const QMimeData *data, Qt::DropAction action, |
| 305 | int row, int column, const QModelIndex &parent) const; |
| 306 | virtual bool dropMimeData(const QMimeData *data, Qt::DropAction action, |
| 307 | int row, int column, const QModelIndex &parent); |
| 308 | virtual Qt::DropActions supportedDropActions() const; |
| 309 | virtual Qt::DropActions supportedDragActions() const; |
| 310 | |
| 311 | virtual bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex()); |
| 312 | virtual bool insertColumns(int column, int count, const QModelIndex &parent = QModelIndex()); |
| 313 | virtual bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex()); |
| 314 | virtual bool removeColumns(int column, int count, const QModelIndex &parent = QModelIndex()); |
| 315 | virtual bool moveRows(const QModelIndex &sourceParent, int sourceRow, int count, |
| 316 | const QModelIndex &destinationParent, int destinationChild); |
| 317 | virtual bool moveColumns(const QModelIndex &sourceParent, int sourceColumn, int count, |
| 318 | const QModelIndex &destinationParent, int destinationChild); |
| 319 | |
| 320 | inline bool insertRow(int row, const QModelIndex &parent = QModelIndex()); |
| 321 | inline bool insertColumn(int column, const QModelIndex &parent = QModelIndex()); |
| 322 | inline bool removeRow(int row, const QModelIndex &parent = QModelIndex()); |
| 323 | inline bool removeColumn(int column, const QModelIndex &parent = QModelIndex()); |
| 324 | inline bool moveRow(const QModelIndex &sourceParent, int sourceRow, |
| 325 | const QModelIndex &destinationParent, int destinationChild); |
| 326 | inline bool moveColumn(const QModelIndex &sourceParent, int sourceColumn, |
| 327 | const QModelIndex &destinationParent, int destinationChild); |
| 328 | |
| 329 | Q_INVOKABLE virtual void fetchMore(const QModelIndex &parent); |
| 330 | Q_INVOKABLE virtual bool canFetchMore(const QModelIndex &parent) const; |
| 331 | Q_INVOKABLE virtual Qt::ItemFlags flags(const QModelIndex &index) const; |
| 332 | virtual void sort(int column, Qt::SortOrder order = Qt::AscendingOrder); |
| 333 | virtual QModelIndex buddy(const QModelIndex &index) const; |
| 334 | Q_INVOKABLE virtual QModelIndexList match(const QModelIndex &start, int role, |
| 335 | const QVariant &value, int hits = 1, |
| 336 | Qt::MatchFlags flags = |
| 337 | Qt::MatchFlags(Qt::MatchStartsWith|Qt::MatchWrap)) const; |
| 338 | virtual QSize span(const QModelIndex &index) const; |
| 339 | |
| 340 | virtual QHash<int,QByteArray> roleNames() const; |
| 341 | |
| 342 | using QObject::parent; |
| 343 | |
| 344 | enum LayoutChangeHint |
| 345 | { |
| 346 | NoLayoutChangeHint, |
| 347 | VerticalSortHint, |
| 348 | HorizontalSortHint |
| 349 | }; |
| 350 | Q_ENUM(LayoutChangeHint) |
| 351 | |
| 352 | enum class CheckIndexOption { |
| 353 | NoOption = 0x0000, |
| 354 | IndexIsValid = 0x0001, |
| 355 | DoNotUseParent = 0x0002, |
| 356 | ParentIsInvalid = 0x0004, |
| 357 | }; |
| 358 | Q_ENUM(CheckIndexOption) |
| 359 | Q_DECLARE_FLAGS(CheckIndexOptions, CheckIndexOption) |
| 360 | |
| 361 | [[nodiscard]] bool checkIndex(const QModelIndex &index, CheckIndexOptions options = CheckIndexOption::NoOption) const; |
| 362 | |
| 363 | virtual void multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const; |
| 364 | |
| 365 | Q_SIGNALS: |
| 366 | void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, |
| 367 | const QList<int> &roles = QList<int>()); |
| 368 | void (Qt::Orientation orientation, int first, int last); |
| 369 | void layoutChanged(const QList<QPersistentModelIndex> &parents = QList<QPersistentModelIndex>(), QAbstractItemModel::LayoutChangeHint hint = QAbstractItemModel::NoLayoutChangeHint); |
| 370 | void layoutAboutToBeChanged(const QList<QPersistentModelIndex> &parents = QList<QPersistentModelIndex>(), QAbstractItemModel::LayoutChangeHint hint = QAbstractItemModel::NoLayoutChangeHint); |
| 371 | |
| 372 | void rowsAboutToBeInserted(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 373 | void rowsInserted(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 374 | |
| 375 | void rowsAboutToBeRemoved(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 376 | void rowsRemoved(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 377 | |
| 378 | void columnsAboutToBeInserted(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 379 | void columnsInserted(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 380 | |
| 381 | void columnsAboutToBeRemoved(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 382 | void columnsRemoved(const QModelIndex &parent, int first, int last, QPrivateSignal); |
| 383 | |
| 384 | void modelAboutToBeReset(QPrivateSignal); |
| 385 | void modelReset(QPrivateSignal); |
| 386 | |
| 387 | void rowsAboutToBeMoved( const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationRow, QPrivateSignal); |
| 388 | void rowsMoved( const QModelIndex &parent, int start, int end, const QModelIndex &destination, int row, QPrivateSignal); |
| 389 | |
| 390 | void columnsAboutToBeMoved( const QModelIndex &sourceParent, int sourceStart, int sourceEnd, const QModelIndex &destinationParent, int destinationColumn, QPrivateSignal); |
| 391 | void columnsMoved( const QModelIndex &parent, int start, int end, const QModelIndex &destination, int column, QPrivateSignal); |
| 392 | |
| 393 | public Q_SLOTS: |
| 394 | virtual bool submit(); |
| 395 | virtual void revert(); |
| 396 | |
| 397 | protected Q_SLOTS: |
| 398 | virtual void resetInternalData(); |
| 399 | |
| 400 | protected: |
| 401 | QAbstractItemModel(QAbstractItemModelPrivate &dd, QObject *parent = nullptr); |
| 402 | |
| 403 | inline QModelIndex createIndex(int row, int column, const void *data = nullptr) const; |
| 404 | inline QModelIndex createIndex(int row, int column, quintptr id) const; |
| 405 | |
| 406 | void encodeData(const QModelIndexList &indexes, QDataStream &stream) const; |
| 407 | bool decodeData(int row, int column, const QModelIndex &parent, QDataStream &stream); |
| 408 | |
| 409 | void beginInsertRows(const QModelIndex &parent, int first, int last); |
| 410 | void endInsertRows(); |
| 411 | |
| 412 | void beginRemoveRows(const QModelIndex &parent, int first, int last); |
| 413 | void endRemoveRows(); |
| 414 | |
| 415 | bool beginMoveRows(const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationRow); |
| 416 | void endMoveRows(); |
| 417 | |
| 418 | void beginInsertColumns(const QModelIndex &parent, int first, int last); |
| 419 | void endInsertColumns(); |
| 420 | |
| 421 | void beginRemoveColumns(const QModelIndex &parent, int first, int last); |
| 422 | void endRemoveColumns(); |
| 423 | |
| 424 | bool beginMoveColumns(const QModelIndex &sourceParent, int sourceFirst, int sourceLast, const QModelIndex &destinationParent, int destinationColumn); |
| 425 | void endMoveColumns(); |
| 426 | |
| 427 | void beginResetModel(); |
| 428 | void endResetModel(); |
| 429 | |
| 430 | void changePersistentIndex(const QModelIndex &from, const QModelIndex &to); |
| 431 | void changePersistentIndexList(const QModelIndexList &from, const QModelIndexList &to); |
| 432 | QModelIndexList persistentIndexList() const; |
| 433 | |
| 434 | private: |
| 435 | Q_DECLARE_PRIVATE(QAbstractItemModel) |
| 436 | Q_DISABLE_COPY(QAbstractItemModel) |
| 437 | }; |
| 438 | |
| 439 | Q_DECLARE_OPERATORS_FOR_FLAGS(QAbstractItemModel::CheckIndexOptions) |
| 440 | |
| 441 | inline bool QAbstractItemModel::insertRow(int arow, const QModelIndex &aparent) |
| 442 | { return insertRows(arow, 1, aparent); } |
| 443 | inline bool QAbstractItemModel::insertColumn(int acolumn, const QModelIndex &aparent) |
| 444 | { return insertColumns(acolumn, 1, aparent); } |
| 445 | inline bool QAbstractItemModel::removeRow(int arow, const QModelIndex &aparent) |
| 446 | { return removeRows(arow, 1, aparent); } |
| 447 | inline bool QAbstractItemModel::removeColumn(int acolumn, const QModelIndex &aparent) |
| 448 | { return removeColumns(acolumn, 1, aparent); } |
| 449 | inline bool QAbstractItemModel::moveRow(const QModelIndex &sourceParent, int sourceRow, |
| 450 | const QModelIndex &destinationParent, int destinationChild) |
| 451 | { return moveRows(sourceParent, sourceRow, 1, destinationParent, destinationChild); } |
| 452 | inline bool QAbstractItemModel::moveColumn(const QModelIndex &sourceParent, int sourceColumn, |
| 453 | const QModelIndex &destinationParent, int destinationChild) |
| 454 | { return moveColumns(sourceParent, sourceColumn, 1, destinationParent, destinationChild); } |
| 455 | inline QModelIndex QAbstractItemModel::createIndex(int arow, int acolumn, const void *adata) const |
| 456 | { return QModelIndex(arow, acolumn, adata, this); } |
| 457 | inline QModelIndex QAbstractItemModel::createIndex(int arow, int acolumn, quintptr aid) const |
| 458 | { return QModelIndex(arow, acolumn, aid, this); } |
| 459 | |
| 460 | class Q_CORE_EXPORT QAbstractTableModel : public QAbstractItemModel |
| 461 | { |
| 462 | Q_OBJECT |
| 463 | |
| 464 | public: |
| 465 | explicit QAbstractTableModel(QObject *parent = nullptr); |
| 466 | ~QAbstractTableModel(); |
| 467 | |
| 468 | QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override; |
| 469 | QModelIndex sibling(int row, int column, const QModelIndex &idx) const override; |
| 470 | bool dropMimeData(const QMimeData *data, Qt::DropAction action, |
| 471 | int row, int column, const QModelIndex &parent) override; |
| 472 | |
| 473 | Qt::ItemFlags flags(const QModelIndex &index) const override; |
| 474 | |
| 475 | using QObject::parent; |
| 476 | |
| 477 | protected: |
| 478 | QAbstractTableModel(QAbstractItemModelPrivate &dd, QObject *parent); |
| 479 | |
| 480 | private: |
| 481 | Q_DISABLE_COPY(QAbstractTableModel) |
| 482 | QModelIndex parent(const QModelIndex &child) const override; |
| 483 | bool hasChildren(const QModelIndex &parent) const override; |
| 484 | }; |
| 485 | |
| 486 | class Q_CORE_EXPORT QAbstractListModel : public QAbstractItemModel |
| 487 | { |
| 488 | Q_OBJECT |
| 489 | |
| 490 | public: |
| 491 | explicit QAbstractListModel(QObject *parent = nullptr); |
| 492 | ~QAbstractListModel(); |
| 493 | |
| 494 | QModelIndex index(int row, int column = 0, const QModelIndex &parent = QModelIndex()) const override; |
| 495 | QModelIndex sibling(int row, int column, const QModelIndex &idx) const override; |
| 496 | bool dropMimeData(const QMimeData *data, Qt::DropAction action, |
| 497 | int row, int column, const QModelIndex &parent) override; |
| 498 | |
| 499 | Qt::ItemFlags flags(const QModelIndex &index) const override; |
| 500 | |
| 501 | using QObject::parent; |
| 502 | |
| 503 | protected: |
| 504 | QAbstractListModel(QAbstractItemModelPrivate &dd, QObject *parent); |
| 505 | |
| 506 | private: |
| 507 | Q_DISABLE_COPY(QAbstractListModel) |
| 508 | QModelIndex parent(const QModelIndex &child) const override; |
| 509 | int columnCount(const QModelIndex &parent) const override; |
| 510 | bool hasChildren(const QModelIndex &parent) const override; |
| 511 | }; |
| 512 | |
| 513 | // inline implementations |
| 514 | |
| 515 | inline QModelIndex QModelIndex::parent() const |
| 516 | { return m ? m->parent(*this) : QModelIndex(); } |
| 517 | |
| 518 | inline QModelIndex QModelIndex::sibling(int arow, int acolumn) const |
| 519 | { return m ? (r == arow && c == acolumn) ? *this : m->sibling(arow, acolumn, *this) : QModelIndex(); } |
| 520 | |
| 521 | inline QModelIndex QModelIndex::siblingAtColumn(int acolumn) const |
| 522 | { return m ? (c == acolumn) ? *this : m->sibling(r, acolumn, *this) : QModelIndex(); } |
| 523 | |
| 524 | inline QModelIndex QModelIndex::siblingAtRow(int arow) const |
| 525 | { return m ? (r == arow) ? *this : m->sibling(arow, c, *this) : QModelIndex(); } |
| 526 | |
| 527 | inline QVariant QModelIndex::data(int arole) const |
| 528 | { return m ? m->data(*this, arole) : QVariant(); } |
| 529 | |
| 530 | inline void QModelIndex::multiData(QModelRoleDataSpan roleDataSpan) const |
| 531 | { if (m) m->multiData(*this, roleDataSpan); } |
| 532 | |
| 533 | inline Qt::ItemFlags QModelIndex::flags() const |
| 534 | { return m ? m->flags(*this) : Qt::ItemFlags(); } |
| 535 | |
| 536 | inline size_t qHash(const QModelIndex &index, size_t seed = 0) noexcept |
| 537 | { return size_t((size_t(index.row()) << 4) + size_t(index.column()) + index.internalId()) ^ seed; } |
| 538 | |
| 539 | QT_END_NAMESPACE |
| 540 | |
| 541 | Q_DECLARE_METATYPE(QModelIndexList) |
| 542 | |
| 543 | #endif // QABSTRACTITEMMODEL_H |
| 544 | |